mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-05 16:13:08 +08:00
bbdd1840de
- Introduced `document-standards.md` to define YAML frontmatter schema, naming conventions, and content structure for spec-generator outputs. - Created `quality-gates.md` outlining per-phase quality gate criteria and scoring dimensions for spec-generator outputs. - Added templates for architecture documents, epics and stories, product briefs, and requirements PRD to streamline documentation in respective phases.
74 lines
2.0 KiB
Markdown
74 lines
2.0 KiB
Markdown
---
|
|
prefix: VERIFY
|
|
inner_loop: true
|
|
cli_tools:
|
|
- gemini --mode analysis
|
|
message_types:
|
|
success: verify_passed
|
|
failure: gaps_found
|
|
error: error
|
|
---
|
|
|
|
# Verifier
|
|
|
|
Goal-backward verification per phase. Reads convergence criteria from IMPL-*.json task files and checks against actual codebase state. Read-only — never modifies code. Produces verification.md with pass/fail and structured gap lists.
|
|
|
|
## Phase 2: Context Loading
|
|
|
|
| Input | Source | Required |
|
|
|-------|--------|----------|
|
|
| Task JSONs | <session>/phase-{N}/.task/IMPL-*.json | Yes |
|
|
| Summaries | <session>/phase-{N}/summary-*.md | Yes |
|
|
| Wisdom | <session>/wisdom/ | No |
|
|
|
|
1. Glob IMPL-*.json files, extract convergence criteria from each task
|
|
2. Glob summary-*.md files, parse frontmatter (task, affects, provides)
|
|
3. If no task JSONs or summaries found → error to coordinator
|
|
|
|
## Phase 3: Goal-Backward Verification
|
|
|
|
For each task's convergence criteria, execute appropriate check:
|
|
|
|
| Criteria Type | Method |
|
|
|---------------|--------|
|
|
| File existence | `test -f <path>` |
|
|
| Command execution | Run command, check exit code |
|
|
| Pattern match | Grep for pattern in specified files |
|
|
| Semantic check | Optional: Gemini CLI (`--mode analysis --rule analysis-review-code-quality`) |
|
|
|
|
**Per task scoring**:
|
|
|
|
| Result | Condition |
|
|
|--------|-----------|
|
|
| pass | All criteria met |
|
|
| partial | Some criteria met |
|
|
| fail | No criteria met or critical check failed |
|
|
|
|
Collect all gaps from partial/failed tasks with structured format:
|
|
- task ID, criteria type, expected value, actual value
|
|
|
|
## Phase 4: Compile Results
|
|
|
|
1. Aggregate per-task results: count passed, partial, failed
|
|
2. Determine overall status:
|
|
- `passed` if gaps.length === 0
|
|
- `gaps_found` otherwise
|
|
3. Write `<session>/phase-{N}/verification.md`:
|
|
|
|
```yaml
|
|
---
|
|
phase: <N>
|
|
status: passed | gaps_found
|
|
tasks_checked: <count>
|
|
tasks_passed: <count>
|
|
gaps:
|
|
- task: "<task-id>"
|
|
type: "<criteria-type>"
|
|
item: "<description>"
|
|
expected: "<expected>"
|
|
actual: "<actual>"
|
|
---
|
|
```
|
|
|
|
4. Update .msg/meta.json with verification summary
|