chore(gitignore): docs/gen/ namespace for generated trees#56
Merged
Conversation
…espace The previous gitignore listed each generated doc target on its own line (docs/agent-brain/, docs/agent-memory/, docs/eval/) — a maintenance tax that grows with every new target. Adopt the convention: every designdoc-generated tree lives under docs/gen/<target>/. A single `docs/gen/` line in .gitignore covers all present and future targets without per-target edits. Hand-written docs (e.g. docs/superpowers/, which holds committed plans and specs) live at docs/<name>/ and remain tracked as before. No code or behavior change; gitignore-only. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Summary
Replaces the per-target list (
docs/agent-brain/,docs/agent-memory/,docs/eval/) with a singledocs/gen/line. Going forward, every designdoc-generated tree lives underdocs/gen/<target>/and the gitignore catches them all without per-target maintenance.Hand-written docs (e.g.
docs/superpowers/plans + specs) stay atdocs/<name>/and remain tracked.Why
Established during the May 2026 trust eval as a scaling pattern — "we're going to generate a lot of these." Three lines of per-target maintenance became one line of namespace convention.
Invariants preserved
docs/superpowers/tree untouched.docs/design/.designdoc-state.json/.designdoc-budget.jsonlines (24-25) andtests/fixtures/*/docs/design/(line 29) stay as-is — different namespace.Test plan
git statusclean after the change (no inadvertent file moves)task ciis unaffected (this is gitignore-only)designdoc generate --output docs/gen/<target>produces an ignored tree🤖 Generated with Claude Code