specsmd 0.0.0-dev.53 → 0.0.0-dev.54

package/flows/fire/agents/builder/agent.md

@@ -155,18 +155,21 @@ Each run creates a folder with its artifacts:
 .specs-fire/runs/{run-id}/
 ├── plan.md          # Approved implementation plan (confirm/validate modes)
 ├── run.md           # Run log (metadata, files changed, decisions)
+├── test-report.md   # Test results, coverage, and acceptance validation
 └── walkthrough.md   # Implementation walkthrough (for human review)
 ```
 
-**The trio**:
+**The quartet**:
 - **plan.md** — What we intended to do (approved at checkpoint)
 - **run.md** — What happened during execution
+- **test-report.md** — Test results and acceptance criteria validation
 - **walkthrough.md** — Human-readable summary after completion
 
 | Artifact | Location | Template |
 |----------|----------|----------|
 | Plan | `.specs-fire/runs/{run-id}/plan.md` | `skills/run-execute/templates/plan.md.hbs` |
 | Run Log | `.specs-fire/runs/{run-id}/run.md` | (generated by script) |
+| Test Report | `.specs-fire/runs/{run-id}/test-report.md` | `skills/run-execute/templates/test-report.md.hbs` |
 | Walkthrough | `.specs-fire/runs/{run-id}/walkthrough.md` | `skills/walkthrough-generate/templates/walkthrough.md.hbs` |
 
 ---

package/flows/fire/agents/builder/skills/run-execute/SKILL.md

@@ -66,7 +66,11 @@ Before executing scripts, ensure required dependencies are installed:
   <step n="2" title="Load Context">
     <action>Read work item from .specs-fire/intents/{intent}/work-items/{id}.md</action>
     <action>Read intent brief for broader context</action>
-    <action>Read project standards (.specs-fire/standards/)</action>
+    <action>Load ALL project standards:</action>
+    <substep>.specs-fire/standards/tech-stack.md — Technology choices</substep>
+    <substep>.specs-fire/standards/coding-standards.md — Code style and patterns</substep>
+    <substep>.specs-fire/standards/testing-standards.md — Testing strategy and coverage</substep>
+    <substep>.specs-fire/standards/system-architecture.md — Architecture context and constraints</substep>
     <action>Determine execution mode from work item</action>
   </step>
 
@@ -163,6 +167,12 @@ Before executing scripts, ensure required dependencies are installed:
   </step>
 
   <step n="6" title="Run Tests">
+    <action>Load testing standards from .specs-fire/standards/testing-standards.md</action>
+    <action>Write tests following testing standards:</action>
+    <substep>Unit tests for new/modified functions</substep>
+    <substep>Integration tests for API endpoints or workflows</substep>
+    <substep>Follow test naming and structure conventions</substep>
+
     <action>Run test suite</action>
     <check if="tests fail">
       <output>
@@ -171,7 +181,11 @@ Before executing scripts, ensure required dependencies are installed:
       <action>Fix failing tests</action>
       <action>Re-run tests</action>
     </check>
-    <action>Record test results and coverage</action>
+
+    <action>Validate acceptance criteria from work item</action>
+    <action>Measure coverage against target from testing-standards.md</action>
+    <action>Generate test report using template: templates/test-report.md.hbs</action>
+    <action>Save to: .specs-fire/runs/{run-id}/test-report.md</action>
   </step>
 
   <step n="7" title="Complete Run">
@@ -193,7 +207,9 @@ Before executing scripts, ensure required dependencies are installed:
       Tests added: {count}
       Coverage: {percentage}%
 
-      Walkthrough: .specs-fire/runs/{run-id}/walkthrough.md
+      Artifacts:
+      - Test Report: .specs-fire/runs/{run-id}/test-report.md
+      - Walkthrough: .specs-fire/runs/{run-id}/walkthrough.md
 
       Continue to next work item? [Y/n]
     </output>

package/flows/fire/agents/builder/skills/run-execute/templates/test-report.md.hbs

@@ -0,0 +1,81 @@
+---
+run: {{run_id}}
+work_item: {{work_item_id}}
+intent: {{intent_id}}
+generated: {{generated_at}}
+status: {{status}}
+---
+
+# Test Report: {{title}}
+
+## Summary
+
+| Category | Passed | Failed | Skipped | Coverage |
+|----------|--------|--------|---------|----------|
+| Unit | {{unit_passed}} | {{unit_failed}} | {{unit_skipped}} | {{unit_coverage}}% |
+| Integration | {{integration_passed}} | {{integration_failed}} | {{integration_skipped}} | {{integration_coverage}}% |
+| **Total** | {{total_passed}} | {{total_failed}} | {{total_skipped}} | {{total_coverage}}% |
+
+## Acceptance Criteria Validation
+
+{{#each acceptance_criteria}}
+- {{#if this.passed}}✅{{else}}❌{{/if}} **{{this.criterion}}** — {{this.status}}
+{{/each}}
+
+## Tests Written
+
+### Unit Tests
+
+{{#each unit_tests}}
+- `{{this.file}}` — {{this.description}}
+{{/each}}
+
+### Integration Tests
+
+{{#each integration_tests}}
+- `{{this.file}}` — {{this.description}}
+{{/each}}
+
+## Test Commands
+
+```bash
+# Run all tests
+{{test_command}}
+
+# Run with coverage
+{{coverage_command}}
+```
+
+## Coverage Details
+
+{{#if coverage_details}}
+| Module | Statements | Branches | Functions | Lines |
+|--------|------------|----------|-----------|-------|
+{{#each coverage_details}}
+| `{{this.module}}` | {{this.statements}}% | {{this.branches}}% | {{this.functions}}% | {{this.lines}}% |
+{{/each}}
+{{else}}
+Coverage details not available.
+{{/if}}
+
+## Issues Found
+
+{{#if issues}}
+| Issue | Severity | Status |
+|-------|----------|--------|
+{{#each issues}}
+| {{this.description}} | {{this.severity}} | {{this.status}} |
+{{/each}}
+{{else}}
+No issues found during testing.
+{{/if}}
+
+## Ready for Completion
+
+- [{{#if all_tests_pass}}x{{else}} {{/if}}] All tests passing
+- [{{#if coverage_met}}x{{else}} {{/if}}] Coverage target met ({{coverage_target}}%)
+- [{{#if acceptance_met}}x{{else}} {{/if}}] All acceptance criteria validated
+- [{{#if no_critical_issues}}x{{else}} {{/if}}] No critical issues open
+
+---
+*Generated by FIRE Run {{run_id}}*

package/flows/fire/agents/orchestrator/skills/project-init/SKILL.md

@@ -104,8 +104,11 @@ Initialize a new FIRE project by detecting workspace type and setting up standar
     <action>Create .specs-fire/runs/</action>
     <action>Create .specs-fire/standards/</action>
     <action>Generate .specs-fire/state.yaml (include autonomy_bias)</action>
-    <action>Generate .specs-fire/standards/tech-stack.md</action>
-    <action>Generate .specs-fire/standards/coding-standards.md</action>
+    <action>Generate standards using templates:</action>
+    <substep>tech-stack.md — templates/tech-stack.md.hbs</substep>
+    <substep>coding-standards.md — templates/coding-standards.md.hbs</substep>
+    <substep>testing-standards.md — templates/testing-standards.md.hbs</substep>
+    <substep>system-architecture.md — templates/system-architecture.md.hbs</substep>
   </step>
 
   <step n="6" title="Complete">
@@ -120,7 +123,9 @@ Initialize a new FIRE project by detecting workspace type and setting up standar
       ├── runs/
       └── standards/
           ├── tech-stack.md
-          └── coding-standards.md
+          ├── coding-standards.md
+          ├── testing-standards.md
+          └── system-architecture.md
       ```
 
       Ready to capture your first intent.
@@ -136,6 +141,10 @@ Initialize a new FIRE project by detecting workspace type and setting up standar
 
 ## Output
 
-- `.specs-fire/state.yaml` — Central state file
-- `.specs-fire/standards/tech-stack.md` — Technology choices
-- `.specs-fire/standards/coding-standards.md` — Coding conventions
+| Artifact | Location | Template |
+|----------|----------|----------|
+| State | `.specs-fire/state.yaml` | — |
+| Tech Stack | `.specs-fire/standards/tech-stack.md` | `templates/tech-stack.md.hbs` |
+| Coding Standards | `.specs-fire/standards/coding-standards.md` | `templates/coding-standards.md.hbs` |
+| Testing Standards | `.specs-fire/standards/testing-standards.md` | `templates/testing-standards.md.hbs` |
+| System Architecture | `.specs-fire/standards/system-architecture.md` | `templates/system-architecture.md.hbs` |

package/flows/fire/agents/orchestrator/skills/project-init/templates/coding-standards.md.hbs

@@ -0,0 +1,149 @@
+# Coding Standards
+
+## Overview
+
+{{overview}}
+
+## Code Formatting
+
+**Tool**: {{formatter}}
+**Config**: {{formatter_config}}
+**Enforcement**: {{formatter_enforcement}}
+
+### Key Settings
+
+{{#each formatter_settings}}
+- **{{this.setting}}**: {{this.value}}
+{{/each}}
+
+## Linting
+
+**Tool**: {{linter}}
+**Base Config**: {{linter_base}}
+**Strictness**: {{linter_strictness}}
+
+### Key Rules
+
+{{#each linter_rules}}
+- `{{this.rule}}`: {{this.setting}} — {{this.rationale}}
+{{/each}}
+
+## Naming Conventions
+
+### Variables and Functions
+
+| Element | Convention | Example |
+|---------|------------|---------|
+{{#each naming_conventions}}
+| {{this.element}} | {{this.convention}} | `{{this.example}}` |
+{{/each}}
+
+### Files and Folders
+
+{{#each file_naming}}
+- **{{this.type}}**: {{this.convention}} (e.g., `{{this.example}}`)
+{{/each}}
+
+## File Organization
+
+### Project Structure
+
+```
+{{project_structure}}
+```
+
+### Conventions
+
+{{#each organization_conventions}}
+- **{{this.item}}**: {{this.convention}}
+{{/each}}
+
+## Import Order
+
+```{{language}}
+{{import_order_example}}
+```
+
+**Rules**:
+{{#each import_rules}}
+- {{this}}
+{{/each}}
+
+## Error Handling
+
+### Pattern
+
+**Approach**: {{error_pattern}}
+
+### Guidelines
+
+{{#each error_guidelines}}
+- {{this}}
+{{/each}}
+
+### Example
+
+```{{language}}
+{{error_example}}
+```
+
+## Logging
+
+**Tool**: {{logging_tool}}
+**Format**: {{logging_format}}
+
+### Log Levels
+
+| Level | Usage |
+|-------|-------|
+{{#each log_levels}}
+| {{this.level}} | {{this.usage}} |
+{{/each}}
+
+### Guidelines
+
+**Always log**:
+{{#each log_always}}
+- {{this}}
+{{/each}}
+
+**Never log**:
+{{#each log_never}}
+- {{this}}
+{{/each}}
+
+## Comments and Documentation
+
+### When to Comment
+
+{{#each comment_guidelines}}
+- {{this}}
+{{/each}}
+
+### Documentation Format
+
+**Functions**: {{doc_format_functions}}
+**Classes**: {{doc_format_classes}}
+
+## Code Patterns
+
+### Preferred Patterns
+
+{{#each preferred_patterns}}
+#### {{this.name}}
+
+{{this.description}}
+
+```{{../language}}
+{{this.example}}
+```
+{{/each}}
+
+### Anti-Patterns to Avoid
+
+{{#each anti_patterns}}
+- **{{this.name}}**: {{this.why}}
+{{/each}}
+
+---
+*Generated by FIRE project-init*

package/flows/fire/agents/orchestrator/skills/project-init/templates/system-architecture.md.hbs

@@ -0,0 +1,101 @@
+# System Architecture
+
+## Overview
+
+{{overview}}
+
+## System Context
+
+{{system_context}}
+
+### Context Diagram
+
+```
+{{context_diagram}}
+```
+
+### Users
+
+{{#each users}}
+- **{{this.name}}**: {{this.description}}
+{{/each}}
+
+### External Systems
+
+{{#each external_systems}}
+- **{{this.name}}**: {{this.purpose}}
+{{/each}}
+
+## Architecture Pattern
+
+**Pattern**: {{architecture_pattern}}
+**Rationale**: {{architecture_rationale}}
+
+## Component Architecture
+
+### Components
+
+{{#each components}}
+#### {{this.name}}
+
+- **Purpose**: {{this.purpose}}
+- **Responsibilities**: {{this.responsibilities}}
+- **Dependencies**: {{this.dependencies}}
+{{/each}}
+
+### Component Diagram
+
+```
+{{component_diagram}}
+```
+
+## Data Flow
+
+{{data_flow_description}}
+
+```
+{{data_flow_diagram}}
+```
+
+## Technology Stack
+
+| Layer | Technology | Purpose |
+|-------|------------|---------|
+{{#each tech_stack}}
+| {{this.layer}} | {{this.technology}} | {{this.purpose}} |
+{{/each}}
+
+## Non-Functional Requirements
+
+### Performance
+
+{{#each nfr_performance}}
+- **{{this.metric}}**: {{this.target}}
+{{/each}}
+
+### Security
+
+{{#each nfr_security}}
+- {{this}}
+{{/each}}
+
+### Scalability
+
+{{scalability_approach}}
+
+## Constraints
+
+{{#each constraints}}
+- {{this}}
+{{/each}}
+
+## Key Decisions
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+{{#each key_decisions}}
+| {{this.decision}} | {{this.choice}} | {{this.rationale}} |
+{{/each}}
+
+---
+*Generated by FIRE project-init*

package/flows/fire/agents/orchestrator/skills/project-init/templates/tech-stack.md.hbs

@@ -0,0 +1,136 @@
+# Tech Stack
+
+## Overview
+
+{{overview}}
+
+## Core Technologies
+
+### Language
+
+**Primary**: {{primary_language}}
+**Version**: {{language_version}}
+
+### Framework
+
+**Framework**: {{framework}}
+**Version**: {{framework_version}}
+**Rationale**: {{framework_rationale}}
+
+### Runtime
+
+**Runtime**: {{runtime}}
+**Version**: {{runtime_version}}
+
+## Data Layer
+
+### Database
+
+**Type**: {{database_type}}
+**Database**: {{database}}
+**Version**: {{database_version}}
+
+### ORM / Data Access
+
+**Tool**: {{orm}}
+**Rationale**: {{orm_rationale}}
+
+### Caching
+
+{{#if caching}}
+**Solution**: {{caching}}
+{{else}}
+Not configured.
+{{/if}}
+
+## API Layer
+
+### API Style
+
+**Style**: {{api_style}}
+
+### Documentation
+
+**Tool**: {{api_docs}}
+
+## Frontend (if applicable)
+
+{{#if frontend}}
+### UI Framework
+
+**Framework**: {{frontend.framework}}
+**Version**: {{frontend.version}}
+
+### Styling
+
+**Approach**: {{frontend.styling}}
+
+### State Management
+
+**Solution**: {{frontend.state_management}}
+{{else}}
+Not applicable (backend-only or CLI project).
+{{/if}}
+
+## Infrastructure
+
+### Hosting
+
+**Platform**: {{hosting_platform}}
+
+### Containerization
+
+{{#if containerization}}
+**Tool**: {{containerization}}
+{{else}}
+Not configured.
+{{/if}}
+
+### CI/CD
+
+**Platform**: {{ci_platform}}
+
+## Development Tools
+
+### Package Manager
+
+**Manager**: {{package_manager}}
+
+### Build Tool
+
+**Tool**: {{build_tool}}
+
+### Linting
+
+**Linter**: {{linter}}
+**Config**: {{linter_config}}
+
+### Formatting
+
+**Formatter**: {{formatter}}
+**Config**: {{formatter_config}}
+
+## Dependencies
+
+### Production Dependencies
+
+{{#each prod_dependencies}}
+- `{{this.name}}` ({{this.version}}) — {{this.purpose}}
+{{/each}}
+
+### Development Dependencies
+
+{{#each dev_dependencies}}
+- `{{this.name}}` ({{this.version}}) — {{this.purpose}}
+{{/each}}
+
+## Version Requirements
+
+| Tool | Minimum Version | Recommended |
+|------|-----------------|-------------|
+{{#each version_requirements}}
+| {{this.tool}} | {{this.minimum}} | {{this.recommended}} |
+{{/each}}
+
+---
+*Generated by FIRE project-init*

package/flows/fire/agents/orchestrator/skills/project-init/templates/testing-standards.md.hbs

@@ -0,0 +1,94 @@
+# Testing Standards
+
+## Overview
+
+{{overview}}
+
+## Testing Framework
+
+**Framework**: {{framework}}
+**Runner**: {{runner}}
+
+## Test Types
+
+| Type | Tool | Location | When to Use |
+|------|------|----------|-------------|
+{{#each test_types}}
+| {{this.type}} | {{this.tool}} | `{{this.location}}` | {{this.when}} |
+{{/each}}
+
+## Coverage Requirements
+
+**Target**: {{coverage_target}}%
+**Enforcement**: {{coverage_enforcement}}
+
+**Critical paths that MUST have coverage:**
+{{#each critical_paths}}
+- {{this}}
+{{/each}}
+
+## Test Naming
+
+**Pattern**: `{{naming_pattern}}`
+
+**Examples**:
+{{#each naming_examples}}
+- `{{this.name}}` — {{this.description}}
+{{/each}}
+
+## Test Structure
+
+```{{language}}
+{{test_structure}}
+```
+
+## Mock Strategy
+
+**Approach**: {{mock_approach}}
+
+**Guidelines**:
+{{#each mock_guidelines}}
+- {{this}}
+{{/each}}
+
+## Test Data
+
+**Strategy**: {{test_data_strategy}}
+
+**Guidelines**:
+{{#each test_data_guidelines}}
+- {{this}}
+{{/each}}
+
+## Running Tests
+
+```bash
+# Run all tests
+{{run_all_command}}
+
+# Run with coverage
+{{run_coverage_command}}
+
+# Run specific test file
+{{run_single_command}}
+
+# Run in watch mode
+{{run_watch_command}}
+```
+
+## CI/CD Integration
+
+{{#if ci_enabled}}
+**Pipeline**: {{ci_pipeline}}
+**Trigger**: {{ci_trigger}}
+
+**Required gates**:
+{{#each ci_gates}}
+- {{this}}
+{{/each}}
+{{else}}
+CI/CD integration not configured.
+{{/if}}
+
+---
+*Generated by FIRE project-init*

package/flows/fire/memory-bank.yaml

@@ -11,7 +11,7 @@ structure:
   - path: runs/
     description: "Execution logs and walkthroughs per run"
   - path: standards/
-    description: "Project standards (tech-stack, coding-standards)"
+    description: "Project standards (tech-stack, coding-standards, testing-standards)"
 
 # Central state file (FIRE's source of truth)
 state:
@@ -67,8 +67,10 @@ naming:
     example: "run-001/"
     note: "Sequential 3-digit number, folder per run"
     contents:
-      - "run.md"        # Run log
-      - "walkthrough.md" # Implementation walkthrough
+      - "plan.md"         # Approved implementation plan (confirm/validate modes)
+      - "run.md"          # Run log
+      - "test-report.md"  # Test results and coverage
+      - "walkthrough.md"  # Implementation walkthrough
 
 # Schema Definition (Source of Truth for Agents)
 schema:
@@ -81,8 +83,13 @@ schema:
   run-folder: ".specs-fire/runs/{run-id}/"
   plan: ".specs-fire/runs/{run-id}/plan.md"
   run-log: ".specs-fire/runs/{run-id}/run.md"
+  test-report: ".specs-fire/runs/{run-id}/test-report.md"
   walkthrough: ".specs-fire/runs/{run-id}/walkthrough.md"
   standards: ".specs-fire/standards/"
+  tech-stack: ".specs-fire/standards/tech-stack.md"
+  coding-standards: ".specs-fire/standards/coding-standards.md"
+  testing-standards: ".specs-fire/standards/testing-standards.md"
+  system-architecture: ".specs-fire/standards/system-architecture.md"
 
   # Agent Ownership
   ownership:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.0.0-dev.53",
+  "version": "0.0.0-dev.54",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {