forge-dev-framework 1.0.1 → 1.2.0

package/dist/templates/.claude/rules/ui-conventions.md.template

@@ -0,0 +1,264 @@
+# UI Conventions — {{projectName}}
+
+> **Scope:** Frontend UI development | **Loaded On-Demand**
+
+---
+
+## Design Principles
+
+{{#if designPrinciples}}
+{{#each designPrinciples}}
+- {{this}}
+{{/each}}
+{{else}}
+- **Clarity over cleverness** — UI should be self-explanatory
+- **Progressive disclosure** — Show complexity only when needed
+- **Responsive by default** — Mobile-first approach
+- **Accessibility first** — WCAG 2.1 AA compliance minimum
+{{/if}}
+
+---
+
+## Component Structure
+
+### File Organization
+{{#if componentStructure}}
+{{componentStructure}}
+{{else}}
+```
+src/
+├── components/
+│   ├── ui/              # Reusable UI primitives
+│   ├── features/        # Feature-specific components
+│   └── layouts/         # Layout components
+├── hooks/               # Custom React hooks
+├── lib/                 # Utility functions
+└── styles/              # Global styles
+```
+{{/if}}
+
+### Component Naming
+{{#if componentNaming}}
+{{componentNaming}}
+{{else}}
+- Use PascalCase: `UserProfile.tsx`, `DataTable.tsx`
+- One component per file
+- Co-locate related files:
+  - `UserProfile.tsx`
+  - `UserProfile.test.tsx`
+  - `UserProfile.stories.tsx`
+  - `user-profile.module.css`
+{{/if}}
+
+---
+
+## Styling Conventions
+
+{{#if styling}}
+{{styling}}
+{{else}}
+### CSS Approach
+- Use CSS Modules or Tailwind (configured in project)
+- No inline styles (except dynamic values)
+- Scoped styles only
+
+### Tailwind Conventions (if applicable)
+- Use utility classes for layout, spacing, colors
+- Create `@apply` components for repeated patterns
+- Don't override component props with arbitrary values
+
+### Theme Variables
+```css
+:root {
+  --color-primary: ...;
+  --color-success: ...;
+  --color-error: ...;
+  --spacing-unit: ...;
+  --radius-sm: ...;
+  --radius-md: ...;
+}
+```
+{{/if}}
+
+---
+
+## Form Patterns
+
+{{#if formPatterns}}
+{{formPatterns}}
+{{else}}
+### Form Validation
+- Client-side validation before submission
+- Show inline errors immediately
+- Disable submit button during submission
+- Clear errors on input change
+
+### Error Display
+- Red outline + error text below field
+- Group errors at top for complex forms
+- Highlight first error field on load
+
+### Success Feedback
+- Toast notification on success
+- Redirect or clear form as appropriate
+{{/if}}
+
+---
+
+## Loading States
+
+{{#if loadingStates}}
+{{loadingStates}}
+{{else}}
+### Skeleton Loading
+- Use skeleton screens for lists, tables
+- Maintain same layout as loaded state
+- Smooth fade-in when content loads
+
+### Button States
+- Show spinner + "Loading..." text
+- Disable button during action
+- Maintain button width to prevent layout shift
+{{/if}}
+
+---
+
+## Empty States
+
+{{#if emptyStates}}
+{{emptyStates}}
+{{else}}
+Every list/table must handle:
+1. **Loading** — Skeleton or spinner
+2. **Empty** — Friendly message + action button
+3. **Error** — Error message + retry button
+4. **No Results** — Message when filters return zero results
+
+Example:
+```
+┌─────────────────────────────┐
+│     No users found           │
+│                             │
+│  Try adjusting your filters  │
+│  or create a new user        │
+│                             │
+│    [Create New User]         │
+└─────────────────────────────┘
+```
+{{/if}}
+
+---
+
+## Responsive Breakpoints
+
+{{#if breakpoints}}
+{{breakpoints}}
+{{else}}
+- Mobile: < 640px
+- Tablet: 640px — 1024px
+- Desktop: > 1024px
+- Large Desktop: > 1280px
+
+Test on real devices or browser dev tools.
+{{/if}}
+
+---
+
+## Accessibility
+
+{{#if accessibility}}
+{{accessibility}}
+{{else}}
+### Minimum Requirements
+- Keyboard navigation for all interactive elements
+- ARIA labels for icon-only buttons
+- Focus indicators on all focusable elements
+- Screen reader text for status messages
+- Color contrast minimum 4.5:1
+
+### Testing
+- Test with keyboard only
+- Test with screen reader (NVDA/VoiceOver)
+- Use axe DevTools extension
+{{/if}}
+
+---
+
+## Data Display
+
+### Tables
+{{#if tablePatterns}}
+{{tablePatterns}}
+{{else}}
+- Sortable headers
+- Pagination (20 rows default)
+- Column filtering for complex tables
+- Row actions menu (⋮)
+- Responsive: card view on mobile
+
+### Status Indicators
+Use consistent colors:
+- 🟢 Green — Active, Success, Online
+- 🟡 Yellow — Pending, Warning, Away
+- 🔴 Red — Error, Failed, Offline
+- 🔵 Blue — Info, Neutral
+- ⚪ Gray — Disabled, Inactive
+{{/if}}
+
+---
+
+## Performance
+
+{{#if performance}}
+{{performance}}
+{{else}}
+### Code Splitting
+- Route-based splitting (automatic)
+- Lazy load heavy components
+- Preload critical resources
+
+### Rendering
+- Use `React.memo` for expensive components
+- Debounce search inputs (300ms)
+- Virtualize long lists (> 100 items)
+{{/if}}
+
+---
+
+## Icon Usage
+
+{{#if icons}}
+{{icons}}
+{{else}}
+- Use {{iconSet}} for icons
+- Standard icon sizes: sm (16px), md (20px), lg (24px), xl (32px)
+- Match icon size to adjacent text
+- Add aria-label for icon-only buttons
+{{/if}}
+
+---
+
+## Typography
+
+{{#if typography}}
+{{typography}}
+{{else}}
+### Font Hierarchy
+- Heading 1: 32px (page titles)
+- Heading 2: 24px (section titles)
+- Heading 3: 18px (card titles)
+- Body: 16px (default)
+- Small: 14px (labels, metadata)
+- XSmall: 12px (captions, timestamps)
+
+### Font Weights
+- Regular (400) — body text
+- Medium (500) — labels, buttons
+- Semibold (600) — headings, emphasized text
+- Bold (700) — rarely used
+{{/if}}
+
+---
+
+> **Token Budget:** ~1000 tokens max
+> **Loaded On-Demand** — Only when working on UI code

package/dist/templates/.planning/forge.config.json.template

@@ -0,0 +1,75 @@
+{
+  "$schema": "../src/schemas/forge.config.schema.json",
+  "project": {
+    "name": "{{projectName}}",
+    "version": "{{version}}",
+    "status": "initialized"
+  },
+  "mode": "{{mode}}",
+  "depth": "{{depth}}",
+  "maxTeammates": {{maxTeammates}},
+  "taskLimit": {{taskLimit}},
+
+  "agentProfile": "{{agentProfile}}",
+  "workflow": {
+    "research": {{workflow.research}},
+    "planCheck": {{workflow.planCheck}},
+    "tribunal": {{workflow.tribunal}},
+    "contractFirst": {{workflow.contractFirst}}
+  },
+
+  "git": {
+    "strategy": "{{git.strategy}}",
+    "branchTemplate": "{{git.branchTemplate}}",
+    "squashOnShip": {{git.squashOnShip}}
+  },
+
+  "paths": {
+    "artifacts": "./",
+    "state": "./state",
+    "events": "./state/events",
+    "contracts": "./contracts",
+    "planning": "./.planning",
+    "worktrees": "./.worktrees"
+  },
+
+  "templates": {
+    "claude": "./src/templates/CLAUDE.md.template",
+    "project": "./src/templates/PROJECT.md.template",
+    "requirements": "./src/templates/REQUIREMENTS.md.template",
+    "roadmap": "./src/templates/ROADMAP.md.template",
+    "plan": "./src/templates/PLAN.md.template",
+    "rules": "./src/templates/.claude/rules",
+    "config": "./src/templates/.planning/forge.config.json.template"
+  },
+
+  "tokenLimits": {
+    "claude": 2000,
+    "requirements": 4000,
+    "plan": 6000,
+    "rules": 1000
+  },
+
+  "roles": {
+    "team-lead": {
+      "name": "Team Lead",
+      "description": "Coordinates the team, manages state, approves artifacts"
+    },
+    "backend": {
+      "name": "Backend Specialist",
+      "description": "Owns /src/api, /src/db, API contracts"
+    },
+    "frontend": {
+      "name": "Frontend Specialist",
+      "description": "Owns /src/ui, /src/components, frontend contracts"
+    },
+    "qa": {
+      "name": "QA Specialist",
+      "description": "Owns /tests, /e2e, quality assurance"
+    },
+    "templates": {
+      "name": "Templates Specialist",
+      "description": "Owns /src/templates, /src/generators, artifact generation"
+    }
+  }
+}

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}}