forge

Guide AI-assisted software projects through disciplined phases from Focus to Evaluate.

Updated Jan 3, 2026
One-click install
npx skills add https://github.com/scottfeltham/forge-skill --skill forge-scottfeltham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge
Source: https://github.com/scottfeltham/forge-skill/tree/main/.claude/skills/forge
Command: npx skills add https://github.com/scottfeltham/forge-skill --skill forge-scottfeltham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

FORGE provides a structured, intent-driven workflow to guide AI-assisted software development, ensuring teams define clear problems, keep focus, and avoid wasted cycles through disciplined phases.

Core Features & Use Cases

  • Phase-driven workflow (Focus, Orchestrate, Refine, Generate, Evaluate) with clear criteria and tests to guide progress.
  • TDD-centered generation with one task per session to reduce context switching and improve quality.
  • CLI tooling and cycle templates to initialize, track progress, and surface learnings across projects.
  • Use Case: Start a feature, advance through cycles with explicit acceptance criteria, and archive completed iterations.

Quick Start

Use FORGE to start a new cycle and move through phases with CLI commands:

  • Initialize in your project: uv run ~/.claude/skills/forge/tools/forge_init.py
  • Create a new cycle: uv run ~/.claude/skills/forge/tools/forge_cycle.py new "feature-name"

Frequently Asked Questions about forge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage AI-assisted software development workflows to avoid wasted cycles?

AI-assisted software development workflows require structured, intent-driven phase management to avoid wasted cycles. Using a cycle-based approach enforces phase discipline and explicit acceptance criteria to keep teams focused and prevent unstructured AI generation.

What is the best way to structure TDD-centered generation for AI coding sessions?

TDD-centered generation for AI coding sessions is best structured by limiting one task per session. This reduces context switching and improves quality by advancing through focused phases with clear, evidence-based criteria and tests.

How do I start a new feature cycle using CLI tooling for AI-driven projects?

To start a new feature cycle using CLI tooling, initialize the project environment with a setup script, then create a new cycle by passing the feature name to a dedicated CLI command. This uses YAML frontmatter and cycle templates to track progress.

Can I write code during the Focus and Refine phases of an intent-driven development cycle?

No, intent-driven development cycles forbid coding during the Focus, Orchestrate, and Refine phases. These phases enforce problem clarity and task breakdown, while actual code generation is reserved for the Generate phase.

Why does AI software development require clear problem statements and phase discipline?

AI software development requires clear problem statements and phase discipline to ensure teams define clear problems and maintain focus. Without explicit acceptance criteria and structured cycles, AI generation lacks direction and produces lower quality output.

Do I need YAML frontmatter and cycle templates to track AI software project progress?

Yes, YAML frontmatter and cycle templates are required to initialize, track progress, and surface learnings across projects. They provide the structured metadata and acceptance criteria needed to advance through development phases.