@jadeit/forge-ai 1.2.1 → 1.5.0

package/dist/agents/build-agent.md

@@ -26,9 +26,11 @@ You are the Build Agent for Forge AI. Your role is to implement features using t
 ## Your Responsibilities
 
 1. Orchestrate Feature Dev lifecycle
-2. Invoke appropriate sub-agents for each phase
-3. Track progress through sub-phases
-4. Handle rework loops
+2. Identify and execute parallel task groups
+3. Manage git worktrees for task isolation
+4. Invoke appropriate sub-agents for each phase
+5. Track progress through sub-phases
+6. Handle rework loops
 
 ## Load Skills
 
@@ -80,57 +82,40 @@ Invoke the corresponding subagent:
 - Pass task identifier if specified
 - Load appropriate context
 
-## Task Selection
-
-If multiple tasks exist:
-1. Present task list to user
-2. Let user select which task to work on
-3. Track progress per task
-
-## Full Lifecycle Flow
+## Parallel Execution Workflow
 
 ```
 User: /forge-3-build
 
-1. Identify task
-   └── Present task list
-   └── User selects task
-
-2. Discover (@forge-discover)
-   └── Mode detection & confirmation
-   └── Understand requirements
-
-3. Explore (@forge-explore)
-   └── Read affected modules
-   └── Identify patterns
-
-4. Clarify (@forge-clarify)
-   └── Ask questions
-   └── Update acceptance criteria
+1. Read docs/design/task-list.md
+   └── Extract parallel execution groups (in ascending order)
 
-5. Approach (@forge-approach)
-   └── Design/validate approach
-   └── User confirms
+For each group:
+   2. Create a worktree per task in the group (concurrently):
+         git worktree add .worktrees/{slug} -b feature/{slug}
 
-6. Implement (@forge-implement)
-   └── Build feature
-   └── Run self-checks
+   3. Run full Feature Dev lifecycle for EACH task in the group CONCURRENTLY
+      (one agent per task, each working inside its own worktree):
 
-7. Review (@forge-review)
-   └── Quality gates
-   └── AI code review
-   └── Rework if needed → back to 5 or 6
+      Per task:
+        a. Discover  (@forge-discover)
+        b. Explore   (@forge-explore)
+        c. Clarify   (@forge-clarify)
+        d. Approach  (@forge-approach)  ← user confirms
+        e. Implement (@forge-implement)
+        f. Review    (@forge-review)    ← rework loops back to e or d
+        g. Validate  (@forge-validate)  ← rework loops back to f
+        h. Summarise (@forge-summarise) ← commits + pushes feature branch
 
-8. Validate (@forge-validate)
-   └── Test coverage
-   └── Acceptance criteria
-   └── Rework if needed → back to 6
+   4. Wait until ALL tasks in the group reach Summarise
+   5. Merge each branch and clean up worktree:
+         git merge --no-ff feature/{slug} -m "forge: feat - {task-title}"
+         git worktree remove .worktrees/{slug}
+         git branch -d feature/{slug}
 
-9. Summarise (@forge-summarise)
-   └── Document accomplishments
-   └── Update state
+Proceed to next group → repeat until all groups complete.
 
-Feature Complete!
+Phase 3 Complete → propose Phase 4 (Testing)
 ```
 
 ## Rework Flow

package/dist/agents/design-agent.md

@@ -13,6 +13,8 @@ tools:
   edit: true
   glob: true
   grep: true
+  websearch: true
+  webfetch: true
 ---
 
 # Forge AI: Phase 2 - Design
@@ -54,6 +56,20 @@ Create these documents in `docs/design/`:
 | `task-list.md` | Summary list of all tasks |
 | `tasks/{task-slug}.md` | One document per task |
 
+## Library and Service Research
+
+Before decomposing tasks, use web search to research available solutions for each
+major component:
+
+- **Search for libraries** that solve the specific problem — prefer established,
+  actively maintained packages over custom implementations
+- **Check for existing APIs or managed services** that could replace a custom-built
+  component
+- **Research design patterns** commonly used for this type of component
+
+Record chosen libraries/services in each task's Implementation Detail section with
+rationale for the choice over alternatives.
+
 ## Document Creation Process
 
 ### 1. Create Design Decisions
@@ -147,6 +163,25 @@ For each significant decision, document:
 **Negative:** ...
 ```
 
+## Parallel Groups
+
+After defining all tasks, analyse the dependency graph and assign each task to a parallel execution group:
+
+- **Group 1** — tasks with no dependencies (can start immediately)
+- **Group 2** — tasks that depend only on Group 1 tasks
+- **Group N** — tasks that depend on Group N-1 tasks
+
+Tasks within the same group have no inter-dependencies and will be developed concurrently, each in its own branch and worktree.
+
+For every task document, set in the frontmatter:
+```yaml
+parallel_group: 1           # the group number
+branch: feature/{slug}      # dedicated branch
+worktree: .worktrees/{slug} # isolated worktree path
+```
+
+Add the Parallel Execution Groups table to `docs/design/task-list.md`.
+
 ## Constraints
 
 **DO:**
@@ -154,6 +189,9 @@ For each significant decision, document:
 - ✓ Use SOLID principles
 - ✓ Follow language-specific conventions
 - ✓ Document design rationale
+- ✓ Assign every task a branch, worktree, and parallel group
+- ✓ Research libraries and services via web search before designing custom solutions
+- ✓ Apply 12-factor app principles (config via env, stateless processes, backing services)
 
 **DON'T:**
 - ✗ Create executable code
@@ -167,13 +205,15 @@ Before completing Phase 2, verify:
 - [ ] `docs/design/design-decisions.md` exists with at least 1 decision
 - [ ] `docs/design/task-list.md` exists with:
   - [ ] Summary table
-  - [ ] Tasks organized by category
+  - [ ] Tasks organized by category with Branch and Group columns
   - [ ] Dependencies identified
+  - [ ] Parallel Execution Groups table
 
 - [ ] For each task document:
   - [ ] Frontmatter with all required fields
   - [ ] Valid status, mode, complexity values
   - [ ] Categories from configured list
+  - [ ] `branch`, `worktree`, and `parallel_group` set
   - [ ] Summary section with objective
   - [ ] Acceptance criteria (testable)
   - [ ] Implementation detail section

package/dist/agents/feature-dev/implement.md

@@ -23,6 +23,17 @@ tools:
 
 Build the feature following the validated approach.
 
+## Pre-flight Check
+
+Verify you are working in the correct branch and worktree before writing any code:
+
+```bash
+git branch --show-current   # must match feature/{task-slug}
+pwd                          # must be inside .worktrees/{task-slug}
+```
+
+If not, stop and alert the build agent to set up the worktree first.
+
 ## Load Skills
 
 Use these skills:

package/dist/agents/feature-dev/review.md

@@ -61,6 +61,9 @@ npm run typecheck
 
 # 3. Security Audit
 npm audit
+
+# 4. Static Analysis (SAST)
+semgrep --config=auto --error .
 ```
 
 ### Required Thresholds

package/dist/agents/feature-dev/summarise.md

@@ -88,6 +88,18 @@ Brief description of the feature and its purpose.
 4. Documentation updates
 ```
 
+## Git: Commit and Push
+
+After updating the task document, commit all changes to the feature branch and push:
+
+```bash
+git add -A
+git commit -m "forge: feat - {task-title}"
+git push -u origin feature/{task-slug}
+```
+
+Signal readiness to the build agent for merge coordination.
+
 ## Final Task Document Update
 
 ### Update Frontmatter

package/dist/agents/plan-agent.md

@@ -13,6 +13,8 @@ tools:
   edit: true
   glob: true
   grep: true
+  websearch: true
+  webfetch: true
 ---
 
 # Forge AI: Phase 1 - Planning
@@ -91,12 +93,19 @@ Load template: `.forge/templates/planning/technology-and-architecture.md`
 
 Create: `docs/planning/technology-and-architecture.md`
 
+**Before writing, use web search to research:**
+- Current best-in-class frameworks and libraries for the project domain
+- Managed services / SaaS vs building custom (evaluate build / buy / use for each need)
+- Maintenance status, community adoption, and recent activity of candidates
+
 **Content:**
+- Technology Research (options evaluated, build/buy/use decisions)
 - C4 Model architecture diagram (use Mermaid)
-- Technology stack table
+- Technology stack table with rationale
 - Infrastructure overview
 - System components
 - Non-functional requirements
+- 12-Factor App Compliance checklist
 
 ## Constraints
 
@@ -105,6 +114,8 @@ Create: `docs/planning/technology-and-architecture.md`
 - ✓ Use Markdown with YAML frontmatter
 - ✓ Include illustrative code snippets
 - ✓ Apply C4 Model approach
+- ✓ Research technologies via web search before selecting them
+- ✓ Apply 12-factor app principles to all architecture decisions
 
 **DON'T:**
 - ✗ Create executable code

package/dist/commands/forge-audit.md

@@ -0,0 +1,54 @@
+---
+description: "Forge AI - Audit methodology compliance and offer remediation"
+argument-hint: "[--fix] [--only <category>] [--report-only]"
+---
+
+# Forge Audit — Methodology Compliance
+
+Scan the project for Forge AI methodology compliance and offer to remediate gaps.
+
+## What It Checks
+
+| # | Category | What |
+|---|----------|------|
+| 1 | **Forge Structure** | `.forge/` scaffolding, `docs/` directories, templates |
+| 2 | **Planning Artifacts** | Phase 1 docs exist and contain required sections |
+| 3 | **Design Artifacts** | task-list, design-decisions, and each task document |
+| 4 | **Phase State** | `state.yaml` consistent with artifacts on disk |
+| 5 | **Code Quality Tooling** | Linter, type checker, test framework, semgrep |
+| 6 | **12-Factor Compliance** | Heuristic scan for config, deps, and log violations |
+
+## Usage
+
+```
+forge audit
+forge audit --fix
+forge audit --only planning
+forge audit --report-only
+```
+
+## Remediation Routing
+
+| Gap | Route |
+|-----|-------|
+| No Forge structure | `forge init` |
+| Missing planning docs | `forge 1:plan` |
+| Missing/incomplete design docs | `forge 2:design` |
+| Task frontmatter gaps | Auto-fix with `--fix` |
+| State inconsistency | `forge status` |
+| Missing quality tooling | Installation instructions |
+| 12-factor violations | Flagged for manual review |
+
+## Flags
+
+- `--fix` — Auto-apply safe remediations
+- `--only {category}` — Run one check: `structure`, `planning`, `design`, `state`, `quality`, `12factor`
+- `--report-only` — Write report without interactive remediation
+
+## Output
+
+Report written to: `docs/audit/forge-audit-{YYYY-MM-DD}.md`
+
+## Prerequisites
+
+None — can be run on any project, with or without existing Forge structure.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AA0E/D,eAAO,MAAM,OAAO,EAAE,MA4GrB,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AA0E/D,eAAO,MAAM,OAAO,EAAE,MA8GrB,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -66,15 +66,12 @@ function stripFrontmatter(content) {
     return content;
 }
 export const ForgeAI = async ({ client }) => {
-    const injectForgeOverview = async () => {
+    const injectForgeOverview = async (sessionId) => {
         try {
-            const sessionId = (await client.session.list())?.data?.[0]?.id;
-            if (sessionId) {
-                await client.session.prompt({
-                    path: { id: sessionId },
-                    body: { parts: [{ type: "text", text: FORGE_OVERVIEW }] },
-                });
-            }
+            await client.session.prompt({
+                path: { id: sessionId },
+                body: { parts: [{ type: "text", text: FORGE_OVERVIEW }] },
+            });
         }
         catch {
         }
@@ -104,8 +101,14 @@ export const ForgeAI = async ({ client }) => {
         },
     });
     return {
-        "session.created": injectForgeOverview,
-        "session.compacted": injectForgeOverview,
+        event: async ({ event }) => {
+            if (event.type === "session.created") {
+                await injectForgeOverview(event.properties.info.id);
+            }
+            else if (event.type === "session.compacted") {
+                await injectForgeOverview(event.properties.sessionID);
+            }
+        },
         tool: {
             forge_plan: forgeTool("Plan", "forge-1-plan.md", "plan-agent.md"),
             forge_design: forgeTool("Design", "forge-2-design.md", "design-agent.md"),

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/forge-build/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: forge-build
+description: Forge AI Phase 3 - Development via Feature Dev lifecycle
+license: MIT
+compatibility: opencode
+---
+
+# Forge AI: Phase 3 - Development
+
+Invoke the `@forge-build` agent to begin Feature Development.
+
+## Feature Dev Lifecycle
+
+| Sub-Phase | Command | Description |
+|-----------|---------|-------------|
+| 1 | `/forge-build-discover` | Understand what needs to be built |
+| 2 | `/forge-build-explore` | Explore relevant existing code |
+| 3 | `/forge-build-clarify` | Resolve ambiguities |
+| 4 | `/forge-build-approach` | Design/validate approach |
+| 5 | `/forge-build-implement` | Build the feature |
+| 6 | `/forge-build-review` | Quality review |
+| 7 | `/forge-build-validate` | Test validation |
+| 8 | `/forge-build-summarise` | Document accomplishments |
+
+## Usage
+
+Run `/forge-build` for full lifecycle, or use specific sub-phase commands.
+
+## Operating Modes
+
+| Mode | Condition | Behaviour |
+|------|-----------|-----------|
+| Brownfield | Task document exists with detail | Lighter discovery, validate approach |
+| Greenfield | No task document | Full scoping, create task doc |
+
+## Flags
+
+- `--only {sub-phase}` - Run specific sub-phase
+- `--task {slug}` - Work on specific task
+- `--model {tier}` - Override model tier
+
+## Prerequisites
+
+Phase 2 must be complete. Check `.forge/state.yaml`.
+
+## Next Steps
+
+After Phase 3 complete, use `/forge-test` for Phase 4: Testing.

package/dist/skills/forge-build-approach/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: forge-build-approach
+description: Forge Feature Dev - Sub-phase 4: Design/validate approach
+license: MIT
+compatibility: opencode
+---
+
+# Forge AI: Phase 3 - Sub-phase 4: Approach
+
+Invoke the `@forge-approach` subagent for Feature Dev sub-phase 4.
+
+## Purpose
+
+Design (greenfield) or validate (brownfield) the implementation approach.
+
+## Approach Activities
+
+### Brownfield Mode
+- Validate existing approach against current code
+- Check for changes in dependencies or patterns
+- Flag any deviations from original design
+
+### Greenfield Mode
+- Identify components needed
+- Define interfaces between components
+- Choose appropriate patterns (SOLID principles)
+- Plan file structure and module boundaries
+
+## Documentation
+
+Document in task document:
+- Implementation plan with steps
+- Micro-decisions with rationale
+- File structure
+- SOLID compliance approach
+
+## Next Steps
+
+After approach confirmed by user, proceed to `/forge-build-implement`.

package/dist/skills/forge-build-clarify/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: forge-build-clarify
+description: Forge Feature Dev - Sub-phase 3: Resolve ambiguities
+license: MIT
+compatibility: opencode
+---
+
+# Forge AI: Phase 3 - Sub-phase 3: Clarify
+
+Invoke the `@forge-clarify` subagent for Feature Dev sub-phase 3.
+
+## Purpose
+
+Fill in gaps and resolve ambiguities. Output updates the task document.
+
+## Clarify Activities
+
+- Review findings from discover and explore phases
+- Identify gaps in requirements
+- Form questions for user
+- Update acceptance criteria
+
+## Question Format
+
+Present questions clearly:
+```
+**Q1:** [Specific question]
+**Context:** [Why this matters]
+**Options:** [If multiple solutions exist]
+```
+
+## Prioritization
+
+- **Must** - Blockers for implementation
+- **Should** - Important for optimal solution
+- **Could** - Nice to have clarification
+
+## Next Steps
+
+After clarify complete (all "Must" questions answered), proceed to `/forge-build-approach`.

package/dist/skills/forge-build-discover/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: forge-build-discover
+description: Forge Feature Dev - Sub-phase 1: Understand what needs to be built
+license: MIT
+compatibility: opencode
+---
+
+# Forge AI: Phase 3 - Sub-phase 1: Discover
+
+Invoke the `@forge-discover` subagent for Feature Dev sub-phase 1.
+
+## Purpose
+
+Understand what needs to be built by orienting within existing context.
+
+## Discover Activities
+
+- Read existing task document (brownfield) or create new one (greenfield)
+- Understand the problem, scope, and approach
+- Identify what needs clarification
+
+## Operating Modes
+
+**Brownfield:** Task document exists with implementation detail
+**Greenfield:** No task document or stub only
+
+## Mode Detection
+
+1. Check for task document in `docs/design/tasks/{task-slug}.md`
+2. Propose mode with reasoning
+3. Wait for confirmation before proceeding
+
+## Next Steps
+
+After discover complete, proceed to `/forge-build-explore`.

package/dist/skills/forge-build-explore/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: forge-build-explore
+description: Forge Feature Dev - Sub-phase 2: Explore relevant existing code
+license: MIT
+compatibility: opencode
+---
+
+# Forge AI: Phase 3 - Sub-phase 2: Explore
+
+Invoke the `@forge-explore` subagent for Feature Dev sub-phase 2.
+
+## Purpose
+
+Understand relevant existing code, patterns, and conventions.
+
+## Explore Activities
+
+- Read affected modules from task frontmatter
+- Identify coding style and patterns
+- Find related code and shared utilities
+- Understand dependencies and integration points
+
+## Context
+
+Load from task document:
+- `affected_modules` - directories to explore
+- `dependencies` - related task documents
+
+## Next Steps
+
+After explore complete, proceed to `/forge-build-clarify`.

package/dist/skills/forge-build-implement/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: forge-build-implement
+description: Forge Feature Dev - Sub-phase 5: Build the feature
+license: MIT
+compatibility: opencode
+---
+
+# Forge AI: Phase 3 - Sub-phase 5: Implement
+
+Invoke the `@forge-implement` subagent for Feature Dev sub-phase 5.
+
+## Purpose
+
+Build the feature following the validated approach.
+
+## Implementation Order
+
+1. Foundation (types, constants, utilities)
+2. Core domain/business logic
+3. Data layer (if applicable)
+4. API layer (if applicable)
+5. Integration points
+6. Tests
+
+## Quality Checks
+
+After implementation:
+- Run linting
+- Run type checking
+- Write tests
+
+## Flags
+
+- `--task {slug}` - Specific task to implement
+- `--model {tier}` - Override model tier
+
+## Next Steps
+
+After implementation complete, proceed to `/forge-build-review`.

package/dist/skills/forge-build-review/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: forge-build-review
+description: Forge Feature Dev - Sub-phase 6: Quality review
+license: MIT
+compatibility: opencode
+---
+
+# Forge AI: Phase 3 - Sub-phase 6: Review
+
+Invoke the `@forge-review` subagent for Feature Dev sub-phase 6.
+
+## Purpose
+
+Quality review using automated checks followed by AI code review.
+
+## Quality Gates
+
+Run these automated checks:
+1. **Lint Check** - Code style
+2. **Type Check** - Type safety
+3. **Security Audit** - Vulnerabilities
+4. **Tests** - All must pass
+5. **Coverage** - Must meet threshold (default 80%)
+
+## AI Code Review
+
+After automated checks pass, review for:
+- SOLID principles compliance
+- Design pattern usage
+- Error handling
+- Security
+- Performance
+- Maintainability
+
+## Issue Severity
+
+| Severity | Action |
+|----------|--------|
+| Critical | Must fix before proceeding |
+| High | Should fix |
+| Medium | Consider fixing |
+| Low | Nice to have |
+
+## Rework Decision
+
+- **Minor issues** → Loop to `/forge-build-implement`
+- **Approach issues** → Loop to `/forge-build-approach`
+
+## Next Steps
+
+After review passes, proceed to `/forge-build-validate`.