feat: Add Role Analysis Reviewer Agent and validation template

- Introduced Role Analysis Reviewer Agent to validate role analysis outputs against templates and quality standards.
- Created a detailed validation ruleset for the system-architect role, including mandatory and recommended sections.
- Added JSON validation report structure for output.
- Implemented execution command for validation process.

test: Add UX tests for HookCard component

- Created comprehensive tests for HookCard component, focusing on delete confirmation UX pattern.
- Verified confirmation dialog appearance, deletion functionality, and button interactions.
- Ensured proper handling of state updates and visual feedback for enabled/disabled status.

test: Add UX tests for ThemeSelector component

- Developed tests for ThemeSelector component, emphasizing delete confirmation UX pattern.
- Validated confirmation dialog display, deletion actions, and toast notifications for undo functionality.
- Ensured proper management of theme slots and state updates.

feat: Implement useDebounce hook

- Added useDebounce hook to delay expensive computations or API calls, enhancing performance.

feat: Create System Architect Analysis Template

- Developed a comprehensive template for system architect role analysis, covering required sections such as architecture overview, data model, state machine, error handling strategy, observability requirements, configuration model, and boundary scenarios.
- Included examples and templates for each section to guide users in producing SPEC.md-level precision modeling.
This commit is contained in:
catlog22
2026-03-05 19:58:10 +08:00
parent bc7a556985
commit 3fd55ebd4b
55 changed files with 4262 additions and 1138 deletions

View File

@@ -0,0 +1,78 @@
# Templates Directory
This directory contains document templates used by workers during execution.
## Available Templates
| Template | Used By | Task | Purpose |
|----------|---------|------|---------|
| [product-brief.md](product-brief.md) | writer | DRAFT-001 | Product vision and high-level requirements |
| [requirements-prd.md](requirements-prd.md) | writer | DRAFT-002 | Detailed product requirements document |
| [architecture-doc.md](architecture-doc.md) | writer | DRAFT-003 | System architecture and design decisions |
| [epics-template.md](epics-template.md) | writer | DRAFT-004 | Epic breakdown and user stories |
## Template Structure
All templates follow this structure:
```markdown
---
title: <Document Title>
type: <product-brief|requirements|architecture|epics>
version: 1.0
created: <ISO8601 timestamp>
author: <role-name>
---
# <Document Title>
## Section 1
...
## Section 2
...
```
## Usage
### By Workers
Workers load templates during Phase 3 (Domain Work):
1. Read template file
2. Fill in sections based on research/context
3. Generate artifact with proper frontmatter
4. Create artifact manifest
### By Coordinator
Coordinator references templates when creating tasks:
- DRAFT-001 → `product-brief.md`
- DRAFT-002 → `requirements-prd.md`
- DRAFT-003 → `architecture-doc.md`
- DRAFT-004 → `epics-template.md`
## Template Customization
To customize templates:
1. Modify template files in this directory
2. Ensure YAML frontmatter structure is preserved
3. Update section headings as needed
4. Test with a sample task
## Document Standards
All generated documents must follow:
- **Formatting**: See [../specs/document-standards.md](../specs/document-standards.md)
- **Quality criteria**: See [../specs/quality-gates.md](../specs/quality-gates.md)
- **Artifact contract**: See [../specs/artifact-contract-spec.md](../specs/artifact-contract-spec.md)
## Cross-References
- **Specifications**: See [../specs/README.md](../specs/README.md)
- **Role specifications**: See [../roles/README.md](../roles/README.md)
- **Writer role**: See [../roles/pipeline/writer.md](../roles/pipeline/writer.md)
- **Main entry**: See [../SKILL.md](../SKILL.md)