27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
|
# Documentation Review: project-scoping-enforcement
|
||
|
|
|
||
|
|
## Summary
|
||
|
|
Review of documentation updates for project scoping enforcement changes.
|
||
|
|
|
||
|
|
## Documentation Plan Compliance
|
||
|
|
- [x] AGENTS.md — updated with `--upgrade`, `--project`, untracked tasks
|
||
|
|
- [x] .rules.md — updated with Project Scoping section, `--project`, untracked tasks
|
||
|
|
- [x] system-prompt.md — updated with Project Scoping section, `--project`, untracked tasks
|
||
|
|
- [x] .agent.md — updated with `--upgrade`, `--project`
|
||
|
|
- [x] .onboarding.md — updated with `--upgrade`, `--project`
|
||
|
|
- [x] prompts/workflow.md — updated with untracked tasks, `--project`
|
||
|
|
- [x] prompts/onboarding.md — updated with `--upgrade`
|
||
|
|
- [x] CHANGELOG.md — updated with all changes
|
||
|
|
|
||
|
|
## Documentation Completeness
|
||
|
|
- Code documentation: N/A (no new public API)
|
||
|
|
- User documentation: Complete
|
||
|
|
- API documentation: N/A
|
||
|
|
|
||
|
|
## Issues Found
|
||
|
|
### Issue 1: Bug 2 from adversarial report — heuristic documentation mismatch
|
||
|
|
- **Severity**: Low
|
||
|
|
- **Description**: The `_infer_state_from_artifacts` heuristic returns `bug_find` for SPEC.md-only tasks, but this isn't documented anywhere. Since `--upgrade` is the only user-facing command that uses it, the documentation should note that inferred phases may need manual correction.
|
||
|
|
|
||
|
|
## Score
|
||
|
|
+5 (Complete, one minor documentation note needed)
|