specsmd 0.0.0-dev.8 → 0.0.0-dev.80

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

@@ -0,0 +1,226 @@
+---
+name: project-init
+description: Initialize a new FIRE project by detecting workspace type and setting up standards.
+version: 1.0.0
+---
+
+<objective>
+Initialize a new FIRE project by detecting workspace type and setting up standards.
+</objective>
+
+<triggers>
+  - User runs `/specsmd-fire` on uninitialized project
+  - No `.specs-fire/state.yaml` exists
+</triggers>
+
+<flow>
+  <step n="1" title="Welcome">
+    <output>
+      Welcome to FIRE (Fast Intent-Run Engineering).
+
+      Let me analyze your project to get started.
+    </output>
+  </step>
+
+  <step n="2" title="Detect Workspace">
+    <action>Analyze project root for existing code</action>
+    <check if="src/ or app/ or main entry points exist">
+      <set>workspace.type = brownfield</set>
+    </check>
+    <check if="minimal files, no source directories">
+      <set>workspace.type = greenfield</set>
+    </check>
+  </step>
+
+  <step n="3a" title="Brownfield Setup" if="workspace.type == brownfield">
+    <output>
+      Existing project detected. I'll analyze your codebase to infer standards.
+    </output>
+    <action>Detect tech stack (language, framework, database)</action>
+    <action>Detect structure (monolith, monorepo)</action>
+    <action>Infer coding patterns</action>
+
+    <monorepo_detection>
+      Check for monorepo indicators:
+      - nx.json, turbo.json, pnpm-workspace.yaml, lerna.json, rush.json
+      - package.json with "workspaces" field
+      - Cargo.toml with [workspace] section
+      - go.work file
+      - Multiple independent package/dependency manifests
+      - Common patterns: packages/*, apps/*, services/*, libs/*
+
+      If any indicator found → workspace.structure = "monorepo"
+    </monorepo_detection>
+
+    <output>
+      Here's what I found:
+
+      **Tech Stack**: {detected_tech}
+      **Structure**: {detected_structure}
+      **Patterns**: {detected_patterns}
+
+      Does this look accurate? [Y/n/edit]
+    </output>
+  </step>
+
+  <step n="3b" title="Greenfield Setup" if="workspace.type == greenfield">
+    <ask>
+      What do you want to build? Tell me about:
+      - What the project does
+      - Target users
+      - Key features
+    </ask>
+    <action>Analyze description, suggest tech stack</action>
+    <output>
+      Based on your description, I suggest:
+
+      **Language**: {suggested_language}
+      **Framework**: {suggested_framework}
+      **Database**: {suggested_database}
+
+      Accept these suggestions? [Y/n/edit]
+    </output>
+  </step>
+
+  <step n="4" title="Choose Autonomy Level">
+    <output>
+      How autonomous should FIRE be when executing work items?
+
+      **[1] Autonomous** — AI executes more freely, fewer checkpoints
+           (medium complexity → autopilot, high → confirm)
+
+      **[2] Balanced** — Standard checkpoints based on complexity (Recommended)
+           (low → autopilot, medium → confirm, high → validate)
+
+      **[3] Controlled** — More human oversight, more checkpoints
+           (low → confirm, medium/high → validate)
+
+      Choose [1/2/3]:
+    </output>
+    <check if="response == 1">
+      <set>workspace.autonomy_bias = autonomous</set>
+    </check>
+    <check if="response == 2">
+      <set>workspace.autonomy_bias = balanced</set>
+    </check>
+    <check if="response == 3">
+      <set>workspace.autonomy_bias = controlled</set>
+    </check>
+    <note>Can be changed later in .specs-fire/state.yaml</note>
+  </step>
+
+  <step n="5" title="Detect Modules" if="workspace.structure == monorepo">
+    <output>
+      Monorepo detected. Let me find and analyze the modules.
+    </output>
+
+    <action>Find module directories by exploring:</action>
+    <substep>Paths from workspace config (nx.json projects, pnpm-workspace.yaml, etc.)</substep>
+    <substep>Common patterns: packages/*, apps/*, services/*, libs/*, modules/*</substep>
+    <substep>Directories with their own dependency manifest</substep>
+
+    <action>For each discovered module, analyze (AI-driven, no hardcoded mappings):</action>
+    <substep>Primary language (from file extensions, config files)</substep>
+    <substep>Build/test commands (from CI config, package scripts, Makefile)</substep>
+    <substep>Linter/formatter (from config files in module)</substep>
+    <substep>Package manager (from lock files, manifests)</substep>
+
+    <output>
+      Found {{module_count}} modules:
+
+      | Module | Language | Test Command | Linter |
+      |--------|----------|--------------|--------|
+      {{#each modules}}
+      | {{path}} | {{language}} | {{test_cmd}} | {{linter}} |
+      {{/each}}
+
+      Create module-specific standards?
+      [c] All modules — create standards for all
+      [s] Select — choose which modules
+      [n] None — I'll create them manually later
+    </output>
+
+    <check if="response == c or response == s">
+      <action>For each selected module, create {module}/.specs-fire/standards/tech-stack.md</action>
+      <note>Only tech-stack.md by default — other standards inherit from root</note>
+    </check>
+  </step>
+
+  <step n="6" title="Create Structure">
+    <action>Create .specs-fire/ directory</action>
+    <action>Create .specs-fire/intents/</action>
+    <action>Create .specs-fire/runs/</action>
+    <action>Create .specs-fire/standards/</action>
+    <action>Generate .specs-fire/state.yaml (include autonomy_bias, workspace.structure)</action>
+    <action>Generate standards using templates:</action>
+    <substep>constitution.md — templates/constitution.md.hbs</substep>
+    <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>
+
+    <check if="workspace.structure == monorepo and modules_selected">
+      <action>For each selected module:</action>
+      <substep>Create {module}/.specs-fire/standards/</substep>
+      <substep>Generate {module}/.specs-fire/standards/tech-stack.md with detected settings</substep>
+    </check>
+  </step>
+
+  <step n="7" title="Complete">
+    <output>
+      FIRE initialized!
+
+      Structure created:
+      ```
+      .specs-fire/
+      ├── state.yaml
+      ├── intents/
+      ├── runs/
+      └── standards/
+          ├── constitution.md        # Universal policies (always inherited)
+          ├── tech-stack.md
+          ├── coding-standards.md
+          ├── testing-standards.md
+          └── system-architecture.md
+      {{#if modules_created}}
+
+      Module standards created:
+      {{#each modules_created}}
+      {{path}}/.specs-fire/standards/
+      └── tech-stack.md
+      {{/each}}
+      {{/if}}
+      ```
+
+      Ready to capture your first intent.
+      What do you want to build?
+    </output>
+    <route_to>planner-agent (intent-capture)</route_to>
+  </step>
+</flow>
+
+<output_artifacts>
+
+  | Artifact | Location | Template |
+  |----------|----------|----------|
+  | State | `.specs-fire/state.yaml` | — |
+  | Constitution | `.specs-fire/standards/constitution.md` | `templates/constitution.md.hbs` |
+  | 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` |
+  | Module Tech Stack | `{module}/.specs-fire/standards/tech-stack.md` | AI-generated |
+</output_artifacts>
+
+<success_criteria>
+  <criterion>Workspace type correctly detected (greenfield/brownfield)</criterion>
+  <criterion>Workspace structure correctly detected (monolith/monorepo)</criterion>
+  <criterion>Tech stack identified or suggested</criterion>
+  <criterion>Autonomy level selected</criterion>
+  <criterion>.specs-fire/ directory structure created</criterion>
+  <criterion>constitution.md generated (universal policies)</criterion>
+  <criterion>Standards files generated from templates</criterion>
+  <criterion>state.yaml created with correct configuration</criterion>
+  <criterion>If monorepo: modules detected and analyzed</criterion>
+  <criterion>If monorepo: module standards created for selected modules</criterion>
+</success_criteria>

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*