# 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)