forge-dev-framework 1.1.0 → 1.2.0

package/dist/templates/CLAUDE.md.template

@@ -0,0 +1,161 @@
+# {{projectName}} - Project Constitution
+
+> **Immutable Configuration** — This file defines the technical foundation. Changes require explicit team approval.
+
+---
+
+## Tech Stack
+
+{{#if techStack.backend}}
+### Backend
+- **Language:** {{techStack.backend.language}}
+- **Framework:** {{techStack.backend.framework}}
+- **Runtime:** {{techStack.backend.runtime}}
+{{/if}}
+
+{{#if techStack.frontend}}
+### Frontend
+- **Language:** {{techStack.frontend.language}}
+- **Framework:** {{techStack.frontend.framework}}
+- **Build:** {{techStack.frontend.build}}
+{{/if}}
+
+{{#if techStack.database}}
+### Database
+- **Primary:** {{techStack.database.primary}}
+{{#if techStack.database.cache}}
+- **Cache:** {{techStack.database.cache}}
+{{/if}}
+{{/if}}
+
+{{#if techStack.infrastructure}}
+### Infrastructure
+- **Hosting:** {{techStack.infrastructure.hosting}}
+- **CI/CD:** {{techStack.infrastructure.cicd}}
+{{/if}}
+
+---
+
+## Core Patterns
+
+{{#each patterns}}
+### {{this.name}}
+{{this.description}}
+
+{{#if this.example}}
+**Example:**
+```{{this.lang}}
+{{this.example}}
+```
+{{/if}}
+{{/each}}
+
+---
+
+## Hard Rules
+
+{{#each rules}}
+### {{this.category}}
+{{#each this.items}}
+- **{{this.title}}:** {{this.description}}
+{{/each}}
+{{/each}}
+
+---
+
+## Code Conventions
+
+### File Organization
+{{#if codeStructure}}
+{{codeStructure}}
+{{/if}}
+
+### Naming Conventions
+{{#if namingConventions}}
+{{namingConventions}}
+{{/if}}
+
+---
+
+## Import Aliases
+
+{{#if importAliases}}
+| Alias | Path |
+|-------|------|
+{{#each importAliases}}
+| `@/{{this.from}}` | `{{this.to}}` |
+{{/each}}
+{{/if}}
+
+---
+
+## Environment Variables
+
+{{#if envVars}}
+| Variable | Required | Description |
+|----------|----------|-------------|
+{{#each envVars}}
+| `{{this.name}}` | {{this.required}} | {{this.description}} |
+{{/each}}
+{{/if}}
+
+---
+
+## Testing Standards
+
+{{#if testing}}
+### Test Organization
+{{testing.structure}}
+
+### Coverage Requirements
+{{testing.coverage}}
+
+### Test Command
+```bash
+{{testing.command}}
+```
+{{/if}}
+
+---
+
+## Git Conventions
+
+### Commit Format
+```
+{{#if commitFormat}}
+{{commitFormat}}
+{{else}}
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+{{/if}}
+```
+
+### Commit Types
+{{#if commitTypes}}
+{{#each commitTypes}}
+- **{{this.type}}:** {{this.description}}
+{{/each}}
+{{/if}}
+
+---
+
+## Deployment
+
+{{#if deployment}}
+### Strategy
+{{deployment.strategy}}
+
+### Environment Promotion
+{{#each deployment.environments}}
+1. **{{this.name}}:** {{this.description}}
+{{/each}}
+{{/if}}
+
+---
+
+> **Token Budget:** ~2000 tokens max
+> **Last Updated:** {{timestamp}}
+> **Version:** {{version}}

package/dist/templates/PLAN.md.template

@@ -0,0 +1,177 @@
+# Execution Plan — {{projectName}}
+
+> Phase: {{currentPhase}} | Status: {{status}}
+
+---
+
+## Phase Overview
+
+### {{phaseName}}
+
+{{phaseDescription}}
+
+**Duration:** {{phaseDuration}}
+**Owner:** {{phaseOwner}}
+**Dependencies:** {{#if phaseDependencies}}{{phaseDependencies}}{{else}}None{{/if}}
+
+---
+
+## Task Breakdown
+
+{{#each tasks}}
+### {{this.id}}: {{this.name}}
+
+**Owner:** {{this.owner}}
+**Type:** {{this.type}}
+**Priority:** {{this.priority}}
+**Status:** {{this.status}}
+
+#### Description
+{{this.description}}
+
+#### Dependencies
+{{#if this.dependencies}}
+- {{this.dependencies}}
+{{else}}
+None
+{{/if}}
+
+#### Files
+{{#if this.files}}
+- Input: {{this.inputs}}
+- Output: {{this.outputs}}
+{{/if}}
+
+#### Contracts
+{{#if this.contracts}}
+- {{this.contracts}}
+{{else}}
+None
+{{/if}}
+
+#### Acceptance Criteria
+{{#each this.acceptance}}
+- {{this}}
+{{/each}}
+
+#### Verification
+```bash
+{{this.verify}}
+```
+
+---
+
+{{/each}}
+
+---
+
+## Dependency Graph
+
+```mermaid
+graph TD
+{{#each dependencies}}
+    {{this.id}}[{{this.label}}]
+    {{#each this.deps}}
+    {{../id}} --> {{this}}
+    {{/each}}
+{{/each}}
+```
+
+### Critical Path
+{{#if criticalPath}}
+The following tasks form the critical path:
+{{#each criticalPath}}
+{{@index}}. {{this}}
+{{/each}}
+{{/if}}
+
+### Parallel Execution Opportunities
+{{#if parallelTasks}}
+These tasks can be executed in parallel:
+{{#each parallelTasks}}
+- **{{this.name}}:** {{this.description}}
+{{/each}}
+{{/if}}
+
+---
+
+## Resource Allocation
+
+| Role | Agent | Tasks | Hours |
+|------|-------|-------|-------|
+{{#each resources}}
+| {{this.role}} | {{this.agent}} | {{this.taskCount}} | {{this.estimatedHours}} |
+{{/each}}
+
+---
+
+## Contracts & Interfaces
+
+{{#if contracts}}
+{{#each contracts}}
+### {{this.name}}
+- **Path:** `{{this.path}}`
+- **Format:** {{this.format}}
+- **Version:** {{this.version}}
+- **Provider:** {{this.provider}}
+- **Consumers:** {{this.consumers}}
+
+{{/each}}
+{{/if}}
+
+---
+
+## Execution Strategy
+
+### Parallel Strategy
+{{#if parallelStrategy}}
+{{parallelStrategy}}
+{{/if}}
+
+### Rollout Plan
+{{#if rolloutPlan}}
+{{rolloutPlan}}
+{{/if}}
+
+### Testing Strategy
+{{#if testingStrategy}}
+{{testingStrategy}}
+{{/if}}
+
+---
+
+## Risk Mitigation
+
+{{#if risks}}
+{{#each risks}}
+### {{this.name}}
+- **Risk:** {{this.description}}
+- **Impact:** {{this.impact}}
+- **Mitigation:** {{this.mitigation}}
+- **Contingency:** {{this.contingency}}
+
+{{/each}}
+{{/if}}
+
+---
+
+## Success Criteria
+
+This phase is complete when:
+
+{{#each successCriteria}}
+{{@index}}. {{this}}
+{{/each}}
+
+---
+
+## Notes
+
+{{#if notes}}
+{{notes}}
+{{/if}}
+
+---
+
+> **Token Budget:** ~6000 tokens max
+> **Last Updated:** {{timestamp}}

package/dist/templates/PROJECT.md.template

@@ -0,0 +1,156 @@
+# {{projectName}}
+
+> {{tagline}}
+
+---
+
+## Vision
+
+{{vision}}
+
+---
+
+## Problem Statement
+
+{{problemStatement}}
+
+---
+
+## Solution Overview
+
+{{solution}}
+
+---
+
+## Tech Stack
+
+{{#if techStack.backend}}
+### Backend
+- **Language:** {{techStack.backend.language}}
+- **Framework:** {{techStack.backend.framework}}
+- **Runtime:** {{techStack.backend.runtime}}
+{{#if techStack.backend.keyLibraries}}
+- **Key Libraries:** {{techStack.backend.keyLibraries}}
+{{/if}}
+{{/if}}
+
+{{#if techStack.frontend}}
+### Frontend
+- **Language:** {{techStack.frontend.language}}
+- **Framework:** {{techStack.frontend.framework}}
+- **Build:** {{techStack.frontend.build}}
+- **Styling:** {{techStack.frontend.styling}}
+{{#if techStack.frontend.stateManagement}}
+- **State Management:** {{techStack.frontend.stateManagement}}
+{{/if}}
+{{/if}}
+
+{{#if techStack.database}}
+### Data
+- **Primary:** {{techStack.database.primary}}
+{{#if techStack.database.orm}}
+- **ORM:** {{techStack.database.orm}}
+{{/if}}
+{{#if techStack.database.migrations}}
+- **Migrations:** {{techStack.database.migrations}}
+{{/if}}
+{{/if}}
+
+{{#if techStack.infrastructure}}
+### Infrastructure
+- **Hosting:** {{techStack.infrastructure.hosting}}
+- **CI/CD:** {{techStack.infrastructure.cicd}}
+{{#if techStack.infrastructure.monitoring}}
+- **Monitoring:** {{techStack.infrastructure.monitoring}}
+{{/if}}
+{{/if}}
+
+---
+
+## Architecture Overview
+
+```
+{{architectureDiagram}}
+```
+
+### System Boundaries
+{{#each systemBoundaries}}
+- **{{this.name}}:** {{this.description}}
+{{/each}}
+
+### Data Flow
+{{#if dataFlow}}
+{{dataFlow}}
+{{/if}}
+
+---
+
+## Core Features
+
+{{#each features}}
+### {{this.name}}
+{{this.description}}
+
+{{#if this.acceptanceCriteria}}
+**Acceptance Criteria:**
+{{#each this.acceptanceCriteria}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+
+---
+
+## Non-Functional Requirements
+
+{{#if nfrs}}
+### Performance
+{{#each nfrs.performance}}
+- {{this}}
+{{/each}}
+
+### Security
+{{#each nfrs.security}}
+- {{this}}
+{{/each}}
+
+### Scalability
+{{#each nfrs.scalability}}
+- {{this}}
+{{/each}}
+
+### Availability
+{{#each nfrs.availability}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+## Success Metrics
+
+{{#each successMetrics}}
+- **{{this.name}}:** {{this.description}} (Target: {{this.target}})
+{{/each}}
+
+---
+
+## Known Constraints
+
+{{#each constraints}}
+- **{{this.type}}:** {{this.description}}
+{{/each}}
+
+---
+
+## Out of Scope (Future Phases)
+
+{{#each outOfScope}}
+- {{this}}
+{{/each}}
+
+---
+
+> **Version:** {{version}}
+> **Last Updated:** {{timestamp}}

package/dist/templates/REQUIREMENTS.md.template

@@ -0,0 +1,221 @@
+# Requirements — {{projectName}}
+
+> Version: {{version}} | Phase: {{currentPhase}}
+
+---
+
+## Functional Requirements
+
+{{#each features}}
+### {{@index}}. {{this.name}}
+
+{{this.description}}
+
+#### User Stories
+{{#each this.userStories}}
+**As a** {{this.role}}
+**I want** {{this.want}}
+**So that** {{this.why}}
+
+{{/each}}
+
+#### Acceptance Criteria
+{{#each this.acceptanceCriteria}}
+**Given** {{this.given}}
+**When** {{this.when}}
+**Then** {{this.then}}
+
+{{/each}}
+
+#### Dependencies
+{{#if this.dependencies}}
+- Depends on: {{this.dependencies}}
+{{/if}}
+
+{{#if this.apiContracts}}
+**API Contracts:** `{{this.apiContracts}}`
+{{/if}}
+
+{{/each}}
+
+---
+
+## Non-Functional Requirements
+
+### Performance
+{{#each nfrs.performance}}
+- {{this}}
+
+{{/each}}
+
+### Security
+{{#each nfrs.security}}
+- {{this}}
+
+{{/each}}
+
+### Reliability
+{{#each nfrs.reliability}}
+- {{this}}
+
+{{/each}}
+
+### Maintainability
+{{#each nfrs.maintainability}}
+- {{this}}
+
+{{/each}}
+
+### Scalability
+{{#each nfrs.scalability}}
+- {{this}}
+
+{{/each}}
+
+---
+
+## Data Requirements
+
+{{#if dataRequirements}}
+### Entities
+{{#each dataRequirements.entities}}
+#### {{this.name}}
+{{#each this.fields}}
+- **{{this.name}}** ({{this.type}}){{#if this.required}} *required*{{/if}}: {{this.description}}
+{{/each}}
+
+{{/each}}
+{{/if}}
+
+---
+
+## API Requirements
+
+{{#if apiRequirements}}
+{{#each apiRequirements}}
+### {{this.name}}
+- **Endpoint:** `{{this.method}} {{this.path}}`
+- **Description:** {{this.description}}
+- **Authentication:** {{this.authentication}}
+- **Rate Limit:** {{this.rateLimit}}
+
+{{#if this.request}}
+**Request:**
+```{{this.request.format}}
+{{this.request.schema}}
+```
+{{/if}}
+
+{{#if this.response}}
+**Response:**
+```{{this.response.format}}
+{{this.response.schema}}
+```
+{{/if}}
+
+{{#if this.errors}}
+**Error Responses:**
+{{#each this.errors}}
+- `{{this.code}}` — {{this.description}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+---
+
+## UI/UX Requirements
+
+{{#if uiRequirements}}
+### Design Principles
+{{#each uiRequirements.principles}}
+- {{this}}
+{{/each}}
+
+### Screen Requirements
+{{#each uiRequirements.screens}}
+#### {{this.name}}
+{{this.description}}
+
+**States:**
+{{#each this.states}}
+- {{this.name}}: {{this.description}}
+{{/each}}
+
+**Interactions:**
+{{#each this.interactions}}
+- {{this}}
+{{/each}}
+
+{{/each}}
+{{/if}}
+
+---
+
+## Integration Requirements
+
+{{#if integrations}}
+{{#each integrations}}
+### {{this.name}}
+- **Type:** {{this.type}}
+- **Purpose:** {{this.purpose}}
+- **Contract:** `{{this.contractPath}}`
+- **SLA:** {{this.sla}}
+
+{{/each}}
+{{/if}}
+
+---
+
+## Testing Requirements
+
+{{#if testing}}
+### Test Coverage
+- Minimum: {{testing.coverage}}%
+- Critical paths: 100%
+
+### Test Types Required
+{{#each.testing.types}}
+- {{this}}
+{{/each}}
+
+### Performance Tests
+{{#if testing.performance}}
+{{testing.performance}}
+{{/if}}
+
+### Security Tests
+{{#if testing.security}}
+{{testing.security}}
+{{/if}}
+{{/if}}
+
+---
+
+## Compliance & Legal
+
+{{#if compliance}}
+{{#each compliance}}
+- **{{this.area}}:** {{this.requirement}}
+{{/each}}
+{{/if}}
+
+---
+
+## Assumptions & Dependencies
+
+### Assumptions
+{{#each assumptions}}
+- {{this}}
+{{/each}}
+
+### External Dependencies
+{{#each dependencies}}
+- **{{this.name}}** (v{{this.version}}) — {{this.purpose}}
+{{/each}}
+
+---
+
+> **Token Budget:** ~4000 tokens max
+> **Last Updated:** {{timestamp}}