@ydtb/specsmd 0.1.22

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 specs.md - fabriqa.ai FIRE Flow*

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

@@ -0,0 +1,43 @@
+# Project Constitution
+
+> Universal policies that apply to ALL code in this project.
+> This file is always inherited from root — modules cannot override it.
+
+## Git Workflow
+
+- **Commit Style**: {{#if commit_style}}{{commit_style}}{{else}}Conventional commits (feat:, fix:, chore:, docs:, refactor:, test:){{/if}}
+- **Branch Strategy**: {{#if branch_strategy}}{{branch_strategy}}{{else}}Feature branches merged via pull request{{/if}}
+- **Main Branch**: {{#if main_branch}}{{main_branch}}{{else}}main{{/if}} is always deployable
+
+## Code Review
+
+- All changes require pull request review
+- {{#if approval_count}}{{approval_count}}{{else}}At least one{{/if}} approval required before merge
+- No self-merging to main/master
+- Security-sensitive changes require additional review
+
+## CI/CD
+
+{{#if ci_platform}}
+- **Platform**: {{ci_platform}}
+{{else}}
+- All PRs must pass CI checks before merge
+{{/if}}
+- Automated tests run on every push
+- Main branch deployments are automated
+
+## Security Policies
+
+- **No secrets in code** — use environment variables or secret management
+- Dependencies must be from trusted sources
+- Security vulnerabilities addressed within SLA
+- No credentials, API keys, or tokens in source control
+
+## Documentation
+
+- Public APIs must be documented
+- Breaking changes require migration notes
+- README kept up to date with setup instructions
+
+---
+*Generated by specs.md - fabriqa.ai FIRE Flow*

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 specs.md - fabriqa.ai FIRE Flow*

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 specs.md - fabriqa.ai FIRE Flow*

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 specs.md - fabriqa.ai FIRE Flow*

package/flows/fire/agents/orchestrator/skills/route/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: route
+description: Analyze project state and route user to the appropriate agent based on current context.
+version: 1.0.0
+---
+
+<objective>
+Analyze project state and route user to the appropriate agent.
+</objective>
+
+<triggers>
+  - User runs `/specsmd-fire` on initialized project
+  - After any agent completes its task
+</triggers>
+
+<llm critical="true">
+  <mandate>ALWAYS scan file system for intents/work-items not in state.yaml</mandate>
+  <mandate>FILE SYSTEM is source of truth — state.yaml may be incomplete</mandate>
+  <mandate>Route based on VERIFIED state, not assumptions</mandate>
+</llm>
+
+<flow>
+  <step n="1" title="Discover and Read State">
+    <action>Read .specs-fire/state.yaml</action>
+
+    <file_system_scan critical="true">
+      Use these EXACT glob patterns:
+
+      <pattern purpose="Find intent briefs">
+        .specs-fire/intents/*/brief.md
+      </pattern>
+
+      <pattern purpose="Find work items">
+        .specs-fire/intents/*/work-items/*.md
+      </pattern>
+
+      Work items are {work-item-id}.md files directly in work-items/ folder.
+    </file_system_scan>
+
+    <action>Reconcile: add discovered items to state as pending</action>
+    <action>Parse current project state</action>
+  </step>
+
+  <step n="2" title="Check Active Run">
+    <check if="runs.active is not empty">
+      <output>
+        Resuming active run: {runs.active[0].id}
+        Scope: {runs.active[0].scope}
+        Current item: {runs.active[0].current_item}
+        Progress: {completed_count}/{total_count} items
+      </output>
+      <route_to>builder-agent (run-execute)</route_to>
+      <stop/>
+    </check>
+  </step>
+
+  <step n="3" title="Check Pending Work Items">
+    <action>Find work items with status == pending across all intents</action>
+    <check if="pending work items exist">
+      <output>
+        **{pending_count} pending work items** found across {intent_count} intent(s).
+
+        Plan run scope and start execution? [Y/n]
+      </output>
+      <check if="response == y">
+        <route_to>builder-agent (run-plan)</route_to>
+      </check>
+      <stop/>
+    </check>
+  </step>
+
+  <step n="4" title="Check Active Intent">
+    <action>Find intents with status == in_progress</action>
+    <check if="active intent has no work items">
+      <output>
+        Intent "{intent.title}" needs decomposition.
+        Routing to Planner to create work items.
+      </output>
+      <route_to>planner-agent (work-item-decompose)</route_to>
+      <stop/>
+    </check>
+    <check if="all work items completed">
+      <action>Mark intent as completed</action>
+      <output>
+        Intent "{intent.title}" completed!
+
+        Work items delivered:
+        {list completed work items}
+
+        Ready for next intent? [Y/n]
+      </output>
+    </check>
+  </step>
+
+  <step n="5" title="No Active Work">
+    <output>
+      No active work. Ready for a new intent.
+
+      What do you want to build?
+    </output>
+    <route_to>planner-agent (intent-capture)</route_to>
+  </step>
+</flow>
+
+<routing_decision_tree>
+
+  ```
+  state.yaml + file system scan
+      │
+      ├── runs.active? ─────────────> Builder (run-execute, resume)
+      │
+      ├── pending work items? ──────> Builder (run-plan, then execute)
+      │
+      ├── intent without work items? > Planner (work-item-decompose)
+      │
+      └── no active intents ────────> Planner (intent-capture)
+  ```
+
+</routing_decision_tree>
+
+<context_passed_to_agents>
+  **To Planner:**
+
+  ```yaml
+  context:
+    action: intent-capture | work-item-decompose
+    intent_id: {if decomposing}
+  ```
+
+  **To Builder:**
+
+  ```yaml
+  context:
+    action: run-plan | run-execute | resume
+    pending_items: [{list of pending work items}]  # for run-plan
+    run_id: {if resuming}
+  ```
+
+</context_passed_to_agents>
+
+<success_criteria>
+  <criterion>File system scanned for untracked intents/work-items</criterion>
+  <criterion>State reconciled with file system</criterion>
+  <criterion>Correct agent selected based on state</criterion>
+  <criterion>Context passed to target agent</criterion>
+</success_criteria>