fix: address review feedback on architecture guidance

- Define DONE_WITH_CONCERNS handling in SDD controller flow
- Make implementer action explicit when file grows beyond plan intent
- Reword writing-plans file size reasoning (avoid tooling-artifact language)
- Add decomposition awareness to code quality reviewer prompt
This commit is contained in:
Jesse Vincent
2026-02-08 12:20:39 -08:00
parent 8d996aa829
commit 21c7284d54
4 changed files with 21 additions and 10 deletions

View File

@@ -23,7 +23,7 @@ Assume they are a skilled developer, but know almost nothing about our toolset o
Before defining tasks, map out which files will be created or modified and what each one is responsible for. This is where decomposition decisions get locked in.
- Design units with clear boundaries and well-defined interfaces. Each file should have one clear responsibility.
- You work best with files you can read in a single pass. Large files cause silent truncation, context degradation, and unreliable edits. Prefer smaller, focused files over large ones that do too much.
- You reason best about code you can hold in context at once, and your edits are more reliable when files are focused. Prefer smaller, focused files over large ones that do too much.
- Files that change together should live together. Split by responsibility, not by technical layer.
- In existing codebases, follow established patterns. If the codebase uses large files, don't unilaterally restructure - but if a file you're modifying has grown unwieldy, including a split in the plan is reasonable.