iforgeai

中文

A multi-platform, multi-role AI agent toolkit for software delivery teams.
Supports GitHub Copilot, Claude Code, Codex CLI, and TraeCN.

by jordium.com

---

iforgeAI provides 10 specialist AI agents — one per delivery role. Each agent has defined inputs, outputs, and handoff points. A coordinator agent (@digital-team) connects them into a sequential workflow with human gate reviews between phases.

To avoid conflicts with existing products using similar names in the market, the project has been renamed from forgeai to iforgeAI.

Backend support: .NET (C#), Java (Spring Boot), and Python (FastAPI). Multiple backend engineers can coexist in a single project.

The DevOps role includes Docker configuration and CI/CD pipeline delivery capabilities, and generates these artifacts on demand based on the docker and cicd settings in .ai/context/workflow-config.md.

VS Code 1.115.0 supports a visual Prompt UI for project initialization, making configuration easier.

---

Quick Start

GitHub Copilot

git clone https://github.com/nelson820125/iforgeai.git
cd iforgeai
pwsh ./install.ps1          # Select platform: 1 Copilot  (or 3 Both)

Then in VS Code:

1. Ctrl+Shift+P → Developer: Reload Window
2. Open your project workspace
3. Copilot Chat → run /init-project to scaffold .ai/ directories
4. Switch to Agent mode → select digital-team → describe your iteration goal

---

Trae (0.6.0+)

Method 1 — Script install (recommended)

git clone https://github.com/nelson820125/iforgeai.git
cd iforgeai
pwsh ./install.ps1          # Select platform: 2 Trae  (or 3 Both)

This installs all role skills globally to ~/.trae-cn/skills/ (Trae CN) or ~/.trae/skills/ (Trae International), and coding-standard instructions to the corresponding instructions/ directory.

After installation, invoke any role in Trae chat using @agent-name:

@digital-team      — coordinator; use /init-project to scaffold a new project
@product-manager   — requirements analysis
@architect         — architecture design
@dba               — database design

Method 2 — One-click shared agents (Trae CN only)

Click to add an agent directly to your Trae workspace (no install required):

Agent	Link
digital-team (coordinator)	Add agent
product-manager	Add agent
project-manager	Add agent
architect	Add agent
dba	Add agent
ui-designer	Add agent
frontend-engineer	Add agent
dotnet-engineer	Add agent
java-engineer	Add agent
python-engineer	Add agent
qa-engineer	Add agent
plan	Add agent
devops-engineer	Add agent

Initialize a project

In Trae chat, use @digital-team and run /init-project to scaffold .ai/ directories for your project:

@digital-team /init-project

The guided interview creates .ai/context/workflow-config.md and copies relevant coding standards from the global instructions into .trae/rules/.

---

Claude Code

# Copy to your project root (or ~/.claude/ for all projects)
cp claude-code/CLAUDE.md /path/to/your/project/CLAUDE.md

Start with a trigger word in Claude Code chat: PM: / Architect: / Frontend: …

---

Codex CLI

cp codex/AGENTS.md /path/to/your/project/AGENTS.md

For Chinese versions, use zh-CN/ prefix: zh-CN/claude-code/CLAUDE.md, zh-CN/codex/AGENTS.md.

---

Roles

Phase	Role	Agent	Output
P1	Product Manager	@product-manager	.ai/temp/requirement.md
P2a	Architect	@architect	.ai/temp/architect.md · .ai/temp/api-contract.md (skeleton)
P2b	DBA	@dba	.ai/temp/db-design.md · .ai/temp/db-init.sql
P3	UI Designer	@ui-designer	.ai/temp/ui-design.md · .ai/temp/ui-wireframe.html · .ai/context/ui-designs/_index.md
P3b	UI Designer · Design Review	@ui-designer (UI review:)	.ai/context/ui-designs/_index.md (finalised) · .ai/temp/ui-design.md (final)
P4	Project Manager	@project-manager	.ai/temp/wbs.md
P5a	Backend Engineer	@dotnet-engineer / @java-engineer / @python-engineer	.ai/temp/api-contract.md (completed)
P5b	Plan	@plan	.ai/temp/plan.md
P6a	Frontend Engineer	@frontend-engineer	Source code
P6b	Backend Engineer	@dotnet-engineer / @java-engineer / @python-engineer	Source code
P6c	Architect	@architect	.ai/reports/architect/review-report-{v}.md
P7	QA Engineer	@qa-engineer	.ai/reports/qa-report.md
P8	DevOps Engineer	@devops-engineer	.ai/reports/devops-engineer/deploy-guide-{v}.md

@digital-team is the Orchestrator. It reads .ai/temp/ to detect the current phase, displays progress, and runs gate reviews.

Copilot Chat (Agent mode): Switch to Agent mode and select agents from the agent picker — the @name above is the agent's picker name, not a chat command. Claude Code / Codex CLI: Use trigger phrases to set role context.

Workflow

flowchart TD
    START(["🚀 Start iteration\n@digital-team"])

    P1["P1 · Product Manager\n@product-manager\nrequirement.md"]
    G1{"Gate 1\nReview"}

    P2A["P2a · Architect\n@architect\narchitect.md + api-contract skeleton"]
    P2B["P2b · DBA\n@dba\ndb-design.md + db-init.sql"]
    G2{"Gate 2\nJoint Review"}

    P3["P3 · UI Designer\n@ui-designer\nui-design.md + wireframe.html"]
    G3{"Gate 3\nReview"}

    P4["P4 · Project Manager\n@project-manager\nwbs.md"]
    G4{"Gate 4\nReview"}

    P5A["P5a · Backend Engineer(s)\n@dotnet / java / python-engineer\napi-contract.md (full schemas)"]
    P5B["P5b · Plan\n@plan\nplan.md"]
    G5{"Gate 5\nReview"}

    P6A["P6a · Frontend Engineer\n@frontend-engineer\nsource code"]
    P6B["P6b · Backend Engineer(s)\n@dotnet / java / python-engineer\nsource code"]
    P6C["P6c · Architect\n@architect /review\nreview-report.md"]
    G6{"Gate 6\nReview"}

    P7["P7 · QA Engineer\n@qa-engineer\nqa-report.md"]
    G7{"Gate 7\nRelease Assessment"}

    P8["P8 · DevOps Engineer\n@devops-engineer"]
    G8{"Deployment\nCapability?"}
    P8A["📋 Deploy Checklist\ndeploy-guide.md"]
    P8B["🐳 Dockerize\nDockerfile · docker-compose.yml"]
    P8C["⚙️ CI/CD Pipeline\npipeline config · auto-trigger"]
    DONE_M(["✅ Human deployment\nManual execution"])
    DONE_A(["🚀 Auto deployment\nMerge to main → CI/CD triggers"])

    REJECT["🔄 Return to role\nfor revision"]

    START --> P1
    P1 --> G1
    G1 -->|Approved| P2A & P2B
    G1 -->|Rejected| REJECT
    P2A & P2B --> G2
    G2 -->|Approved| P3
    G2 -->|Rejected| REJECT
    P3 --> G3
    G3 -->|Approved| P4
    G3 -->|Rejected| REJECT
    P4 --> G4
    G4 -->|Approved| P5A & P5B
    G4 -->|Rejected| REJECT
    P5A & P5B --> G5
    G5 -->|Approved| P6A & P6B
    G5 -->|Rejected| REJECT
    P6A & P6B --> P6C
    P6C --> G6
    G6 -->|Approved| P7
    G6 -->|Rejected| REJECT
    P7 --> G7
    G7 -->|Approved| P8
    G7 -->|Issues found| REJECT
    P8 --> G8
    G8 -->|No Docker / No CI/CD| P8A
    G8 -->|Docker only| P8B
    G8 -->|CI/CD enabled| P8C
    P8A & P8B --> DONE_M
    P8C --> DONE_A

---

Requirements

• VS Code 1.99 or later with the GitHub Copilot and GitHub Copilot Chat extensions installed and active
• PowerShell 7+ (pwsh) for the installer

Install PowerShell 7 if not already present:

# Windows
winget install Microsoft.PowerShell

# macOS
brew install powershell

---

Installation

1. Clone the repository

GitHub:

git clone https://github.com/nelson820125/iforgeai.git
cd iforgeai

Gitee:

git clone https://gitee.com/jordium/iforgeai.git
cd iforgeai

2. Run the installer

pwsh ./install.ps1

The installer detects your OS and shows the default target path for each component (agents, skills, instructions, prompts). Press Enter to accept a path or type a replacement.

Available flags:

| Flag | Effect