Scaffold the standard norikit project structure#1
Merged
Conversation
Flesh out the previously empty template repo into the full project scaffold
described in norikit/ai-docs/project-structure.md, using stack-agnostic
placeholders so it fits any language/stack a new tool chooses.
Adds:
- README.md (branding skeleton: badges, hero <picture>, WIP note, {{TOKENS}})
- CLAUDE.md (agent front door -> ai-docs/, standing rules, worktree sync-first)
- TEMPLATE.md (how-to-use + placeholder map; self-deletes after bootstrap)
- ai-docs/ knowledge base: README index + decisions/architecture/open-questions/
status/glossary, with the D#/Q# ID scheme and maintenance protocol
- tasks/README.md (board + task.md frontmatter schema)
- .github/workflows/ci.yml (graceful, self-activating: steps skip until inputs exist)
- .github/dependabot.yml (github-actions live + commented language placeholders)
- Sources/ + Tests/ READMEs, .gitignore, assets/ placeholder
License unchanged (AGPL-3.0).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Builds the empty
templaterepo out into the full norikit project scaffold — the standard structure every new project starts from. Uses stack-agnostic placeholders so it fits whatever language/stack a tool chooses.Why
norikit/norikit/ai-docs/new-project.mdinstructs new projects to "create the repo from the template scaffold." Until now the template held only aLICENSE, so that instruction couldn't be followed. This makes it real, and keeps the structure consistent withai-docs/project-structure.md.Contents
<picture>, WIP note,{{TOKENS}})ai-docs/, standing rules (keep KB current; always branch/PR; worktree sync-first)decisions/architecture/open-questions/status/glossary, with theD#/Q#ID scheme and maintenance protocoltask.mdfrontmatter schema::notice::until a build manifest / lint config exists)github-actionsecosystem live + commented language placeholdersLicense unchanged (AGPL-3.0).
Verification
🤖 Generated with Claude Code