Documentation
README
Collaborative Judgment
When to Decide vs When to Ask
Most decisions are NOT ambiguous. The AI decides on its own when:
- The rule is clear. An 80-line function doing 5 things violates SRP. A domain entity importing the database breaks the dependency rule. Fix it.
- The project has a documented preference. The knowledge base, refiner docs, or context anchor specify the choice -- follow it. That is not ambiguity; it is documented intent.
- The impact is low. Variable naming, import order, test data -- choose and move on.
- Grounding is solid. You can point to a source: user instruction, inspected code/artifact, failing test/log, knowledge base, refiner doc, context anchor. Never take a repo-specific fact from memory alone.
This is the opening of the README. Read the full README on GitHub.