thanhnvandClaude Opus 4.8
36a4812ef3
Standard production layout: the OKR app (was nested under AINative_OKR_CASAN5/) is now
the repository root. No more wrapper directory.
- Promote AINative_OKR_CASAN5/* -> repo root (backend/ frontend/ packages/ apps/
.specify/ docs/ infra/ nginx/ scripts/ + configs). Merge tool dirs: .gitea (kept the
active deploy ci.yml, added harness-ci.yml + runbooks), .claude (agents/commands +
launch.json), .github moved up.
- Remove redundant: 00_SUBMISSION_PACKAGE, scattered root notes (FPT_CASAN_Full.md,
tu-tuong-casan.md, casan-tu-sinh..., casan_harness_assessment.md, source-review...,
README_CASAN5_REFINED.md), casan-next-plans/ and optimize-docs/ (competition/planning
artifacts — roadmap + design history preserved in git log / commit messages).
- Update all references to the old layout:
- .gitea/workflows/{ci,harness-ci}.yml, .github/workflows/{ci,deploy}.yml:
working-directory .; drop AINative_OKR_CASAN5/ prefix; .specify/{tests,scripts}
-> packages/casan-harness/... (.specify/logs state kept)
- .claude/launch.json, .gitea/*-runbook.md: path prefixes
- CLAUDE.md, README.md: docs/input -> apps/okr/domain/input
- policy-bundle.yaml: 8 policy paths -> packages/casan-harness/...; manifest re-signed
- secrets-scan.sh: fixture excludes -> new package/domain paths.
Full gate from the new root: PASS=64 FAIL=0 SKIP=3.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
103 lines
3.4 KiB
Markdown
103 lines
3.4 KiB
Markdown
# 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
|