{"id":49296378,"url":"https://github.com/two-weeks-team/previewforgeforclaudecode","last_synced_at":"2026-04-26T04:01:18.677Z","repository":{"id":353050106,"uuid":"1217772021","full_name":"Two-Weeks-Team/PreviewForgeForClaudeCode","owner":"Two-Weeks-Team","description":"3-DD Methodology: PreviewDD → SpecDD → TestDD. 143 Opus 4.7 agents turn one-line idea → frozen full-stack app. Claude Code plugin. Built with Opus 4.7 hackathon.","archived":false,"fork":false,"pushed_at":"2026-04-22T22:38:15.000Z","size":454,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T00:29:44.581Z","etag":null,"topics":["3-dd","anthropic","claude-code","claude-code-plugin","hackathon","multi-agent","nestia","nextjs","openapi","opus-4-7","preview-driven-development","spec-driven-development","test-driven-development","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/blob/main/preview-forge-proposal.html","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Two-Weeks-Team.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-22T07:49:12.000Z","updated_at":"2026-04-22T22:38:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode","commit_stats":null,"previous_names":["two-weeks-team/previewforgeforclaudecode"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/Two-Weeks-Team/PreviewForgeForClaudeCode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Two-Weeks-Team%2FPreviewForgeForClaudeCode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Two-Weeks-Team%2FPreviewForgeForClaudeCode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Two-Weeks-Team%2FPreviewForgeForClaudeCode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Two-Weeks-Team%2FPreviewForgeForClaudeCode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Two-Weeks-Team","download_url":"https://codeload.github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Two-Weeks-Team%2FPreviewForgeForClaudeCode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32285283,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"online","status_checked_at":"2026-04-26T02:00:05.962Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["3-dd","anthropic","claude-code","claude-code-plugin","hackathon","multi-agent","nestia","nextjs","openapi","opus-4-7","preview-driven-development","spec-driven-development","test-driven-development","typescript"],"created_at":"2026-04-26T04:01:17.748Z","updated_at":"2026-04-26T04:01:18.666Z","avatar_url":"https://github.com/Two-Weeks-Team.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Preview Forge for Claude Code\n\n### `TDD` drove code with tests. `SpecDD` drove code with specs. We put `PreviewDD` in front.\n\n**A self-contained Claude Code plugin that introduces the 3-DD Methodology.**\n143 Opus 4.7 agents turn a one-line idea into a frozen full-stack app with only two human clicks.\n\n[![CI](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/actions/workflows/ci.yml/badge.svg)](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/actions/workflows/ci.yml)\n[![Marketplace Validate](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/actions/workflows/marketplace-validate.yml/badge.svg)](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/actions/workflows/marketplace-validate.yml)\n[![Pages](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/actions/workflows/pages.yml/badge.svg)](https://two-weeks-team.github.io/PreviewForgeForClaudeCode/)\n[![Release](https://img.shields.io/github/v/release/Two-Weeks-Team/PreviewForgeForClaudeCode?display_name=tag\u0026sort=semver)](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/releases)\n[![License: Apache 2.0](https://img.shields.io/github/license/Two-Weeks-Team/PreviewForgeForClaudeCode)](LICENSE)\n\n[![Built with Opus 4.7](https://img.shields.io/badge/Built%20with-Claude%20Opus%204.7-d4a574?logo=anthropic\u0026logoColor=white)](https://www.anthropic.com/claude/opus)\n[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-7aa6c2?logo=anthropic\u0026logoColor=white)](https://code.claude.com/docs/en/plugins)\n[![143 Agents](https://img.shields.io/badge/Agents-143-84c984)](preview-forge-proposal.html)\n[![3-DD Methodology](https://img.shields.io/badge/Methodology-PreviewDD%20%E2%86%92%20SpecDD%20%E2%86%92%20TestDD-d4a574)](#the-3-dd-methodology)\n[![14 Slash Commands](https://img.shields.io/badge/%2Fpf%3A*-14%20commands-7aa6c2)](#slash-commands)\n[![Stars](https://img.shields.io/github/stars/Two-Weeks-Team/PreviewForgeForClaudeCode?style=social)](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/stargazers)\n\n\u003c/div\u003e\n\n---\n\n## About\n\n**Preview Forge** is a Claude Code plugin submitted to the\n[Built with Opus 4.7](https://cerebralvalley.ai/events/~/e/built-with-4-7-hackathon)\nhackathon (April 21–28, 2026, Anthropic × Cerebral Valley).\n\nIt encodes a new software-development methodology — **3-DD** — as a 143-agent\nvirtual engineering organization that runs entirely inside Claude Code, with\nonly Anthropic-native dependencies (no Figma, no external CDN, no third-party\nSaaS). One line of idea in. One frozen full-stack app out. Two human clicks.\n\n## The 3-DD Methodology\n\n| Cycle | Stages | Driven by | Locked artifact |\n|---|---|---|---|\n| ① **PreviewDD** \u003csub\u003e(new)\u003c/sub\u003e | 1–3 | 26 mockups diverge direction before any spec | `chosen_preview.json` + `mockups/chosen.html` |\n| 🔒 Gate H1 \u003csub\u003e(human)\u003c/sub\u003e | — | Claude Design (main) / built-in Studio (fallback) | `design-approved.json` |\n| ② **SpecDD** | 4–5 | OpenAPI spec drives implementation (nestia) | `specs/openapi.yaml` + SHA-256 `.lock` |\n| ③ **TestDD** | 6–7 | Tests + scoreboard drive freeze (≥499/500) | `score/report.json` + `.frozen-hash` |\n| 🚀 Gate H2 \u003csub\u003e(human)\u003c/sub\u003e | — | Deployment approval | Deployed URL or tarball |\n\nAll three cycles follow the **diverge → aggregate → lock** shape.\n[Full specification (v8.0)](preview-forge-proposal.html) — 2,100+ lines,\nsingle HTML file, print-friendly.\n\n## Quick Install\n\n```bash\n# 1. Add this marketplace\n/plugin marketplace add Two-Weeks-Team/PreviewForgeForClaudeCode\n\n# 2. Install the plugin\n/plugin install pf@two-weeks-team\n\n# 3. Reload\n/reload-plugins\n\n# 4. Initialize memory (first time only)\n/pf:bootstrap\n\n# 5. Run (profile defaults to `standard` as of v1.4.0)\n/pf:new \"한 줄 아이디어\"\n\n# …or pick a profile explicitly:\n/pf:new \"demo-class idea\"     --profile=standard   # default — ~60k tok · 2×5 eng · 9 previews · SQLite · no Docker\n/pf:new \"real project\"        --profile=pro         # ~250k tok · 3×5 eng · 18 previews · Postgres + Docker\n/pf:new \"production launch\"   --profile=max         # ~600k tok · 5×5 eng · 26 previews · full CI/CD\n```\n\n## Profiles (v1.4+)\n\n| Profile | Previews | Eng teams | DB | Container | Panels | SCC iter | P95 ceiling | Use for |\n|---|---|---|---|---|---|---|---|---|\n| **standard** *(default)* | 9 | 2×5 (BE+FE) | **SQLite** | ❌ none | keyword-trigger | 3 | ~60k tok / 25 min | Local MVP · demo · prototyping |\n| **pro** | 18 | 3×5 (+DB) | Postgres (dev-prod parity) | Docker + compose | keyword-trigger + escalation | 4 | ~250k tok / 70 min | Real projects |\n| **max** | 26 | 5×5 (all) | Postgres | Docker + CI/CD | always-on | 5 | ~600k tok / 160 min | Production · baselines |\n\n- `--previews=N` overrides the count (bounded by `max_user_expand` = 26).\n- `--no-cache` bypasses the PreviewDD-level cache (7 days for standard/pro, never cached for max).\n- Standard = local-first: `npm install \u0026\u0026 npm run db:push \u0026\u0026 npm run dev` — no Docker, no Postgres setup. DB lives at `~/.preview-forge/\u003cproject\u003e/dev.db` (outside repo tree for security).\n- Upgrade path: standard → pro via `bash scripts/graduate.sh pro` (additive; keeps your code, adds Dockerfile/compose/Postgres datasource).\n- Full spec: [`plugins/preview-forge/profiles/`](plugins/preview-forge/profiles/).\n\n### Profile escalation (v1.4+)\n\nWhen you run standard but your idea mentions enterprise signals (Stripe, PII, HIPAA, SSO provider, SOC2, multi-tenant), the plugin recommends the right profile **before** PreviewDD burns tokens:\n\nEvaluation precedence (highest wins):\n\n1. **Hard-require** (Stripe / PII / HIPAA / auth-provider): **any single** hit forces upgrade. You cannot dismiss — false assurance is worse than friction. The `min_distinct_categories=2` floor does NOT apply here.\n2. **Soft-suggest + category-floor** (SOC2 / multi-tenant / B2B / scale): needs **≥2 distinct categories** AND score ≥ threshold to ask via AskUserQuestion. Records your answer in `~/.preview-forge/escalation-history.json`. If you decline, same signals won't re-prompt within 24h (anti-nagging).\n3. **Hint** (weak signals, score \u003c threshold but ≥ min-floor): shows \"💡 Consider --profile=pro next time\" in `/pf:status`, no interruption.\n\nCategorical scoring (not raw keyword count) means `\"audit logging feature\"` in a generic marketing copy app won't false-positive — it's one category, below the 2-category floor.\n\n### Cost regression + drift detection (v1.3+)\n\n- **Rule 9 idea-drift detector** (`hooks/idea-drift-detector.py`) catches the failure where Gate H1 picks product A but SpecDD/Engineering drift to product B. Containment coefficient over token sets (no external ML deps). Block threshold 0.3, warn at 0.4.\n- **P0-B cost-regression sentinel** (`hooks/cost-regression.py`) compares `cost-snapshot.json` against the active profile's P95/hard ceiling every 30s. Hard breach triggers auto-pause + AskUserQuestion handoff.\n\n## Updating\n\nWe release patches and feature updates frequently (see\n[CHANGELOG.md](CHANGELOG.md) and [Releases](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/releases)).\nTo update your local install:\n\n```bash\n# Check installed version\nclaude plugin list | grep -A2 pf@two-weeks-team\n\n# Pull the latest manifest + plugin contents from the marketplace\n/plugin marketplace update two-weeks-team\n\n# Upgrade the plugin to the newest listed version\n/plugin update pf@two-weeks-team     # if you have this subcommand\n#   — or, if update is not available in your Claude Code version —\n/plugin uninstall pf@two-weeks-team\n/plugin install pf@two-weeks-team\n\n# Reload so hooks, agents, and commands refresh\n/reload-plugins\n```\n\nAfter updating, run `pf check` (or `/pf:bootstrap` once, then `pf check`) to\nconfirm your local `~/.claude/preview-forge/memory/` is still intact — the\nupdate does **not** overwrite your `LESSONS.md`, so any cross-run learning\nyou've accumulated is preserved.\n\n**Downgrading** (if a new version breaks something):\n\n```bash\n/plugin uninstall pf@two-weeks-team\n/plugin install pf@two-weeks-team@1.0.0    # any past version tag\n```\n\nEvery release is signed via [GitHub Releases](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode/releases),\nso you can verify the manifest `version` in `plugin.json` matches the tag.\n\n## Slash Commands\n\nPreview Forge ships **14 slash commands** under the `/pf:*` namespace:\n\n### 🚀 Run lifecycle\n| Command | Purpose |\n|---|---|\n| `/pf:bootstrap` | Initialize plugin memory (CLAUDE / PROGRESS / LESSONS) — first time only |\n| `/pf:new \u003cidea\u003e` | Start a new run (PreviewDD cycle begins) |\n| `/pf:status` | Current run state, agent progress, blackboard |\n| `/pf:retry \u003cagent\\|phase\u003e` | Rerun a failed agent or stuck phase |\n| `/pf:freeze` | Force Judges + Auditors evaluation (TestDD Stage 7) |\n\n### 🗳️ Decision gates\n| Command | Purpose |\n|---|---|\n| `/pf:design` | Gate H1 — Claude Design main / built-in Studio fallback |\n| `/pf:panel` | Manually trigger 4-Panel (TP/BP/UP/RP) vote |\n\n### 📚 Assets \u0026 history\n| Command | Purpose |\n|---|---|\n| `/pf:gallery` | Browse / fork past runs |\n| `/pf:replay \u003crun\u003e` | Deterministic replay from `trace.jsonl` |\n| `/pf:seed` | Pre-verified demo idea bank (10) |\n| `/pf:export \u003crun\u003e` | Package frozen run as tarball or Claude Code plugin |\n\n### 📊 Observability\n| Command | Purpose |\n|---|---|\n| `/pf:budget` | Cost dashboard — per-run / per-cycle / per-agent |\n| `/pf:lessons` | Cross-run failure catalog (`LESSONS.md`) |\n| `/pf:help` | Full 14-command reference + FAQ |\n\n## Agent Organization\n\nPreview Forge's 143 agents live in a 6-tier hierarchy + SQLite blackboard:\n\n```\n                        M1 Run Supervisor (Meta)\n                               │\n              ┌────────────────┼────────────────┐\n              │                │                │\n      M2 Cost Monitor     M3 Chief Eng PM   Software-Factory\n       (tracking only)  (all dept leads)   Layer-0 Hooks\n                               │\n    ┌──────────┬───────────────┼────────────────┬─────────────┐\n    │          │               │                │             │\n Ideation  4 Panels +       Spec Dept     5 Engineering     QA Dept +\n  Dept      Mitigation       (9)          Teams (25)        SCC + Judges +\n  (29)     Designer (45)                                    Auditors + Docs\n                                                                (32)\n```\n\nCount: **3 Meta + 29 Ideation + 45 Panels + 9 Spec + 25 Engineering + 14 QA + 5 SCC + 5 Judges + 5 Auditors + 3 Docs = 143**.\nAll Opus 4.7, zero Sonnet/Haiku.\n\n## Requirements\n\n- **Claude Code** (latest) with **Pro / Max / Team / Enterprise** subscription.\n  *(No separate API key needed.)*\n- **Node.js 20** LTS + **pnpm 9** (for scaffolded apps' build/test)\n- **Docker 24+** (optional, for scaffolded apps' `docker compose up` verification)\n\n## What's inside the plugin\n\n| Area | Count | Summary |\n|---|---|---|\n| **Agents** | 143 | 10 departments, 6 tiers, all Opus 4.7 |\n| **Slash commands** | 14 | `/pf:*` namespace |\n| **Hooks** | 3 | `factory-policy.py`, `askuser-enforcement.py`, `auto-retro-trigger.py` |\n| **Memory seed** | 3 | `CLAUDE.md` + `PROGRESS.md` + `LESSONS.md` (with 3 bootstrap lessons) |\n| **Methodology** | 1 | Layer-0 7 non-negotiable rules |\n| **Asset templates** | 4 | Docker Compose, Caddyfile, nestia.config.ts, install.sh |\n| **JSON schemas** | 3 | PreviewCard, PanelVote, ScoreReport |\n| **Seed ideas** | 10 | Pre-verified demo scenarios |\n| **Slash commands** | 14 | `/pf:*` |\n| **CLI** | 1 | `bin/pf` |\n| **Verification** | 1 | `scripts/verify-plugin.sh` (34 checks) |\n\n## Zero third-party dependencies\n\nPreview Forge uses **only Anthropic-native** features:\n\n- Claude Code (Pro/Max) · Claude Opus 4.7 · Adaptive thinking · `xhigh` effort\n- Claude Managed Agents · Anthropic Memory Tool · Batch API · Files API · Citations\n- Context editing (`context-management-2025-06-27`) · Compaction (`compact_20260112`)\n- Prompt caching (1-hour TTL) · Fine-grained tool streaming · Task budgets (`task-budgets-2026-03-13`)\n- Claude Design (Gate H1 main) · Built-in Design Studio (Gate H1 fallback)\n\n**Not used**: Figma, Google Fonts, external CDNs, analytics services.\nAll 26 mockups are single-file HTML with inline styles only.\n\n## Memory \u0026 cross-run learning\n\nPreview Forge maintains a **4-layer memory** so mistakes don't repeat across runs:\n\n1. **`memory/CLAUDE.md`** — session rules (read first every run)\n2. **`memory/PROGRESS.md`** — run index (updated at run end)\n3. **`memory/LESSONS.md`** — failure catalog (auto-appended by Auto-retro critic)\n4. **Anthropic Memory Tool** (`memory_20250818`) — per-agent episodic memory (Reflexion pattern)\n\nM1 Run Supervisor reads all four before every new run and pre-loads relevant\nlessons to every Department Lead.\n\n## Documentation\n\n- 📘 **[Full v8.0 Specification](preview-forge-proposal.html)** — canonical, 2,100+ lines\n- 📝 **[CHANGELOG](CHANGELOG.md)** — phase-by-phase build log\n- 🛡️ **[Security Policy](SECURITY.md)** — reporting and scope\n- 🤝 **[Contributing](CONTRIBUTING.md)** — LESSONS, new advocates, etc.\n- 🪶 **[Layer-0 Rules](plugins/preview-forge/methodology/global.md)** — 7 non-negotiable\n\n## Verify install\n\n```bash\ngit clone https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode\ncd PreviewForgeForClaudeCode\nbash scripts/verify-plugin.sh   # 34/34 checks\n```\n\n## Hackathon\n\nBuilt for the Anthropic × Cerebral Valley\n[Built with Opus 4.7 hackathon](https://cerebralvalley.ai/events/~/e/built-with-4-7-hackathon)\n(April 21–28, 2026). Targeted prize categories:\n\n- 🏆 **Most Creative Opus 4.7** — 143 parallel personas + self-critic + self-scoring\n- 🏆 **Best Managed Agents** — hours-long build/test/correct cycles in a managed session\n- 🏆 **Keep Thinking** — \"TDD + SpecDD didn't touch ideation. We put **PreviewDD** in front.\"\n\n## License\n\n[Apache-2.0](LICENSE). See [NOTICE](NOTICE) for attribution.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n\u003csub\u003eBuilt with **Claude Opus 4.7** · Powered by **Claude Code Plugins** · **Zero third-party deps** · Apache-2.0\u003c/sub\u003e\n\n\u003csub\u003e[Preview Forge](https://github.com/Two-Weeks-Team/PreviewForgeForClaudeCode) · [Two-Weeks-Team](https://github.com/Two-Weeks-Team)\u003c/sub\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwo-weeks-team%2Fpreviewforgeforclaudecode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftwo-weeks-team%2Fpreviewforgeforclaudecode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwo-weeks-team%2Fpreviewforgeforclaudecode/lists"}