{"id":33760501,"url":"https://github.com/alto9/forge","last_synced_at":"2026-04-02T14:19:43.369Z","repository":{"id":323372325,"uuid":"1092627577","full_name":"alto9/forge","owner":"alto9","description":"VSCode extension to provide behavior driven planning and development to your project","archived":false,"fork":false,"pushed_at":"2026-03-31T12:33:50.000Z","size":16136,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T12:47:43.642Z","etag":null,"topics":["ai","context-engineering","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alto9.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-09T01:27:29.000Z","updated_at":"2026-03-31T12:33:51.000Z","dependencies_parsed_at":"2026-02-05T15:02:09.298Z","dependency_job_id":null,"html_url":"https://github.com/alto9/forge","commit_stats":null,"previous_names":["alto9/forge"],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/alto9/forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alto9%2Fforge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alto9%2Fforge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alto9%2Fforge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alto9%2Fforge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alto9","download_url":"https://codeload.github.com/alto9/forge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alto9%2Fforge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31307749,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","context-engineering","vscode-extension"],"created_at":"2025-12-05T10:05:18.480Z","updated_at":"2026-04-02T14:19:43.313Z","avatar_url":"https://github.com/alto9.png","language":"TypeScript","readme":"# Forge Studio\n\nVSCode/Cursor extension for context engineering and agentic development. Forge Studio helps teams maintain product vision, technical concepts, and roadmaps—then turns milestones into actionable, implementation-ready issues via a staged agent workflow.\n\n## Overview\n\nForge Studio provides:\n\n- **Initialize Cursor Agents** – Installs agents/commands/skills/hooks to `~/.cursor/` (user-level)\n- **Initialize Project** – Creates `.forge/` in the current project\n- **Forge Help persona** – Workflow explainer for command/agent guidance and handoff questions\n- **Agent workflow** – Six-step flow: **Product Owner** → **Architect** → **Planner** → **Technical Writer** → **Engineer** → **Quality Assurance**, plus **Forge Help** for workflow questions. Agents install to `~/.cursor/agents/` from `resources/workflow/`. Shared context lives in the project’s **`.forge/`** folder: any agent may update those files when contracts are wrong or unclear; **Product Owner** owns `vision.json` / `project.json`, and **Architect** is the primary steward of `knowledge_map.json` and cross-domain coherence (see `resources/workflow/agents/AGENT_FLOW.md`).\n- **Commands** – architect-this, plan-roadmap, refine-issue, build-from-github, build-from-pr-review, review-pr (injected via Cursor-agent initialization)\n- **Chat participants** – @forge-help, @product-owner, @architect, @planner, @technical-writer, @engineer, @quality-assurance (VSCode chat participants mirror Cursor agents)\n\n## Quick Start\n\n1. Open a project in Cursor or VSCode\n2. On Cursor startup, Forge checks user-level Cursor agents in `~/.cursor/` and prompts before applying updates when changes are needed\n3. Run **Forge: Initialize Project** from the Command Palette (`Cmd/Ctrl+Shift+P`) to create project-level `.forge/`\n4. Forge creates:\n   - `~/.cursor/` – agents, commands, skills, hooks (user-level, shared across projects)\n   - `~/.cursor/hooks.json` – JSON schema validation on .forge file edits\n   - `.forge/` – vision.json, project.json, skill_registry.json, knowledge_map.json, schemas/ (project-level)\n\n## User Flow\n\nAfter Cursor-agent initialization, use the injected agents and commands:\n\n- **Architect** (`/architect-this`) – Aligns `.forge/knowledge_map.json` and domain contract docs with product intent; hands off to Planner\n- **Plan Roadmap** (`/plan-roadmap`) – Manages GitHub milestones and issues via pull-milestones, pull-milestone-issues\n- **Refine Issue** (`/refine-issue`) – Step 4 **orchestration** (normalize input, delegate, verify outputs); the **Technical Writer** agent carries out refinement (parent branch linked, optional sub-issues, no per-sub-issue branches). Authoritative details: `resources/workflow/commands/refine-issue.md` and `resources/workflow/agents/tech-writer.md`.\n- **Build from GitHub** (`/build-from-github`) – Creates/links implementation branch for the issue, implements, runs all tests/lint until green, then commit/PR\n- **Build from PR Review** (`/build-from-pr-review`) – Retrieves PR feedback, checks out PR branch, applies requested changes, validates, and pushes updates for re-review\n- **Review PR** (`/review-pr`) – Reviews code, posts review comments\n\n## Chat Participants (VSCode)\n\nType `@` in chat to use Forge personas:\n\n| Participant | Purpose |\n|-------------|---------|\n| **@forge-help** | Workflow guide for Forge steps, commands, handoffs, and quality gates |\n| **@product-owner** | Step 1: maintain product vision and project direction |\n| **@architect** | Step 2: update technical contracts and knowledge structure |\n| **@planner** | Step 3: align milestones and issues with documented direction |\n| **@technical-writer** | Step 4: Technical Writer agent refines issues into implementation-ready work (invocation contract for `/refine-issue` is in `resources/workflow/commands/refine-issue.md`) |\n| **@engineer** | Step 5: implement scoped issue work and prepare PRs |\n| **@quality-assurance** | Step 6: review PRs for correctness and security |\n\n## Project Structure\n\nAfter setup:\n\n**User-level (~/.cursor/):**\n```\n~/.cursor/\n├── agents/                   # product-owner, architect, planner, technical-writer, engineer, quality-assurance, forge-help (+ AGENT_FLOW.md)\n├── commands/                 # architect-this, plan-roadmap, refine-issue, build-from-github, build-from-pr-review, review-pr\n├── skills/                   # gh-driven workflow skills (branch, commit, milestone operations)\n├── hooks/                    # JSON schema validation on .forge file edits\n└── hooks.json                # Cursor hooks config\n```\n\n**Project-level (.forge/):**\n```\nyour-project/\n└── .forge/\n    ├── vision.json           # Product vision, mission, strategy\n    ├── project.json          # Project config (GitHub URL, paths)\n    ├── skill_registry.json   # Skill-to-agent assignments\n    ├── knowledge_map.json    # Domain structure (vision → runtime, business_logic, data, etc.)\n    └── schemas/              # JSON schemas for validation\n```\n\n## Installation\n\n### From Source (Development)\n\n```bash\nnpm install\nnpm run build\nnpm run package\ncode --install-extension forge-studio-*.vsix\n```\n\n### From VSIX\n\n```bash\ncode --install-extension forge-studio-*.vsix\n```\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm run watch      # Watch mode\nnpm run lint\nnpm run test\nnpm run package    # Package for distribution\n```\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falto9%2Fforge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falto9%2Fforge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falto9%2Fforge/lists"}