update first - 84
This commit is contained in:
@@ -0,0 +1,102 @@
|
||||
# Phase Report Templates
|
||||
|
||||
Sub-agents SHOULD reference these templates instead of embedding full report structures inline.
|
||||
Read the appropriate template file BEFORE writing your phase report.
|
||||
|
||||
## Universal Report Structure
|
||||
|
||||
Every phase report MUST include these sections (in Vietnamese):
|
||||
|
||||
```markdown
|
||||
# STEP <NN>: <Report Title>
|
||||
|
||||
## Summary
|
||||
- **Target Feature:** <feature name>
|
||||
- **Created At:** <yyyy-MM-dd HH:mm:ss>
|
||||
- **Agent:** <agent-name> (<model>)
|
||||
- **Result:** ✅ Success / ❌ Failure
|
||||
|
||||
## Input
|
||||
- <list input files>
|
||||
|
||||
## Output
|
||||
| # | File | Path |
|
||||
|---|---------|------|
|
||||
| 1 | <file> | <path> |
|
||||
|
||||
## Key Decisions
|
||||
- <list important decisions>
|
||||
|
||||
## Quality Assessment
|
||||
| Category | Result |
|
||||
|---------|------|
|
||||
| <category> | ✅ / ❌ |
|
||||
|
||||
## Metrics
|
||||
| Metric | Value |
|
||||
|-----------|-----|
|
||||
| <metric> | <N> |
|
||||
|
||||
## [AUTO-RESOLVED] Assumptions
|
||||
| # | ID | Original Question | Automatic Answer | Rationale | Confidence |
|
||||
|---|----|---------|---------|------|--------|
|
||||
|
||||
> If none apply: "No auto-resolved items."
|
||||
|
||||
## [NEEDS CLARIFICATION] Items
|
||||
| # | ID | Description | Impact | Related |
|
||||
|---|----|------|--------|------|
|
||||
|
||||
> If there are no unresolved items: "No unresolved items — all requirements are clear."
|
||||
|
||||
## Issues & Retries
|
||||
> If there were no issues or retries: "No issues or retries."
|
||||
|
||||
## Next Step
|
||||
- Next phase: `<agent>` (STEP N+1) — <purpose>
|
||||
- Input: `<path>`
|
||||
```
|
||||
|
||||
## Step-Specific Titles & Extra Sections
|
||||
|
||||
| NN | Report Title | Agent | Extra Sections |
|
||||
|----|-------------|-------|----------------|
|
||||
| 01 | SRS Generation Report | okr.srs | — |
|
||||
| 02 | BD Generation Report | okr.bd | — |
|
||||
| 03 | Specification Creation Report | speckit.specify | — |
|
||||
| 04 | Specification Clarification Report | speckit.clarify | `## QA Summary` (full question + answer table) |
|
||||
| 05 | Specification Review Report | okr.reviewspec | `## CRITICAL Issues` |
|
||||
| 06 | Implementation Plan Report | speckit.plan | — |
|
||||
| 07 | Plan Review Report | okr.reviewplan | `## CRITICAL Issues` |
|
||||
| 08 | DD Generation Report | okr.dd | — |
|
||||
| 08b | Test Case Generation Report | okr.testkit | — |
|
||||
| 09 | Task Generation Report | speckit.tasks | — |
|
||||
| 10 | Implementation and Build Verification Report | speckit.implement | `## Test Results`, `## Screen Verification` |
|
||||
| 11 | Code Review Report | okr.reviewcode | `## CRITICAL Issues`, `## Architecture Assessment` |
|
||||
| 12 | Test Execution Report | okr.testkit | `## Test Execution Summary`, `## Failed Test Details`, `## Coverage`, `## Overall Verdict` |
|
||||
| 13 | Launch Report | Boss (direct) | `## Launch Status` |
|
||||
|
||||
## Review Agent Verdict Sections (Steps 5, 7, 11)
|
||||
|
||||
Review agents add:
|
||||
```markdown
|
||||
## Review Results
|
||||
| Category | Result | CRITICAL | MINOR |
|
||||
|---------|------|----------|-------|
|
||||
|
||||
## CRITICAL Issues
|
||||
| # | Issue | Impact | Recommended Action |
|
||||
|---|------|------|----------|
|
||||
|
||||
> If there are no critical issues: "No CRITICAL issues."
|
||||
```
|
||||
|
||||
## Generation Agent Quality Sections (Steps 1, 2, 3, 6, 8, 9)
|
||||
|
||||
Generation agents include step-specific metrics in the `## Metrics` table. Examples:
|
||||
- **SRS:** FEA count, TBC count, requirement count
|
||||
- **BD:** screen count, logical table count, external interface count
|
||||
- **Spec:** user story count, functional requirement count, screen count
|
||||
- **Plan:** entity count, contract count, implementation phase count
|
||||
- **DD:** physical table count, API count, batch job count
|
||||
- **Tasks:** task count, phase count, dependency link count
|
||||
Reference in New Issue
Block a user