{"id":45540031,"url":"https://github.com/guild-agents/guild","last_synced_at":"2026-03-05T22:09:30.903Z","repository":{"id":340032085,"uuid":"1164239082","full_name":"Guild-Agents/guild","owner":"Guild-Agents","description":"A multi-agent framework for Claude Code — 8 specialized agents and 10 skill workflows for any project","archived":false,"fork":false,"pushed_at":"2026-03-01T21:33:23.000Z","size":775,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-01T21:46:16.207Z","etag":null,"topics":["ai","ai-agents","anthropic","claude","claude-code","cli","developer-tools","framework","multi-agent","nodejs","npm-package","workflow-automation"],"latest_commit_sha":null,"homepage":"https://github.com/guild-agents/guild","language":"JavaScript","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/Guild-Agents.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"2026-02-22T20:53:42.000Z","updated_at":"2026-03-01T19:42:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Guild-Agents/guild","commit_stats":null,"previous_names":["guild-agents/guild"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/Guild-Agents/guild","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guild-Agents%2Fguild","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guild-Agents%2Fguild/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guild-Agents%2Fguild/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guild-Agents%2Fguild/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Guild-Agents","download_url":"https://codeload.github.com/Guild-Agents/guild/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guild-Agents%2Fguild/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30148217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T16:58:46.102Z","status":"ssl_error","status_checked_at":"2026-03-05T16:58:45.706Z","response_time":93,"last_error":"SSL_read: 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","ai-agents","anthropic","claude","claude-code","cli","developer-tools","framework","multi-agent","nodejs","npm-package","workflow-automation"],"created_at":"2026-02-23T03:29:53.413Z","updated_at":"2026-03-05T22:09:30.895Z","avatar_url":"https://github.com/Guild-Agents.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Guild\n\n[![npm version](https://img.shields.io/npm/v/guild-agents)](https://www.npmjs.com/package/guild-agents)\n[![CI](https://github.com/guild-agents/guild/actions/workflows/ci.yml/badge.svg)](https://github.com/guild-agents/guild/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Node.js \u003e= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)\n\n**Guild makes Claude Code think before it builds.**\n\nGuild is a spec-driven development CLI for Claude Code. It installs structured design and development workflows as `.claude/` markdown files in any project. Before code is written, features are evaluated, debated by independent AI perspectives, and specified in a design doc. Everything is markdown, tracked by git, works offline, zero infrastructure.\n\n## The Problem\n\nWithout structure, Claude Code:\n\n- Writes code before understanding the problem\n- Has no design phase and no review gate\n- Loses decisions between sessions\n- Produces results that vary with every conversation\n\n## How Guild Solves It\n\n- **Spec before code**: every feature starts with a design doc\n- **Structured deliberation**: `/council` runs parallel independent analysis -- multiple perspectives evaluate independently, then synthesize\n- **Decisions that persist**: design docs, session state, and project context live in git-tracked markdown\n- **Zero infrastructure**: no servers, no APIs, just markdown files and Claude Code\n\n## Quick Start\n\n```bash\nnpm install -g guild-agents\nguild init\n```\n\nThen use skills as slash commands in Claude Code:\n\n```text\n/guild-specialize        # Learn your codebase, enrich CLAUDE.md\n/council \"Add JWT auth\"  # Spec a feature through structured deliberation\n/build-feature           # Implement from spec through the full pipeline\n```\n\n## The Pipeline\n\n```text\nYou ──\u003e /council \"Add JWT auth\"\n         │\n         ▼\n    ┌──────────┐     ┌──────────────┐     ┌──────────┐\n    │ Evaluate │────\u003e│  Design Doc  │────\u003e│  Build   │\n    │ debate   │     │  spec        │     │ implement│\n    └──────────┘     └──────────────┘     └────┬─────┘\n                                               │\n                                         ┌─────┴─────┐\n                                         ▼           ▼\n                                   ┌──────────┐┌──────────┐\n                                   │  Review  ││    QA    │\n                                   └──────────┘└──────────┘\n```\n\nSix phases: **evaluate**, **specify**, **plan**, **implement**, **review**, **validate**. Phases 1-3 happen before any code is written.\n\n## Skills Reference\n\nAll 11 skills, grouped by function:\n\n| Skill | Group | Description |\n| --- | --- | --- |\n| `/build-feature` | Pipeline | Full pipeline: evaluate, spec, implement, review, QA |\n| `/new-feature` | Pipeline | Create branch and scaffold for a new feature |\n| `/create-pr` | Pipeline | Create a structured pull request from current branch |\n| `/council` | Decision | Multi-perspective deliberation on a decision or feature |\n| `/review` | Quality | Code review on the current diff |\n| `/qa-cycle` | Quality | QA and bugfix loop until clean |\n| `/guild-specialize` | Context | Explore codebase, enrich CLAUDE.md with real conventions |\n| `/session-start` | Context | Load context and resume work |\n| `/session-end` | Context | Save state to SESSION.md |\n| `/status` | Context | Project and session state overview |\n| `/dev-flow` | Context | Show current pipeline phase and next step |\n\n## CLI Commands\n\n```bash\nguild init              # Interactive project onboarding\nguild new-agent \u003cname\u003e  # Create a custom agent\nguild status            # Show project status\nguild doctor            # Diagnose setup\nguild list              # List agents and skills\nguild run \u003cskill\u003e       # Preview a skill's execution plan (dry-run)\nguild logs              # View execution traces\nguild logs clean        # Remove old traces (--days N, --all)\n```\n\n## Under the Hood\n\nGuild coordinates 10 specialized agents through the pipeline. Each agent handles one phase.\n\n| Agent | Role |\n| --- | --- |\n| advisor | Evaluates ideas and provides strategic direction |\n| product-owner | Turns approved ideas into concrete tasks |\n| tech-lead | Defines technical approach and architecture |\n| developer | Implements features following project conventions |\n| code-reviewer | Reviews quality, patterns, and technical debt |\n| qa | Testing, edge cases, regression validation |\n| bugfix | Bug diagnosis and resolution |\n| db-migration | Schema changes and safe migrations |\n| platform-expert | Diagnoses Claude Code integration issues |\n| learnings-extractor | Extracts compound learnings from pipeline executions |\n\nAgents are flat `.md` files with identity and expertise. Skills orchestrate agents through structured pipelines. Everything lives in `.claude/`, readable by humans, tracked by git.\n\n## Guild Builds Itself\n\nEvery feature in Guild goes through the same spec-first pipeline that Guild installs in your project. Guild's own design decisions live in `docs/specs/`.\n\n## Requirements\n\n- Node.js \u003e= 20\n- Claude Code\n- `gh` CLI (optional, for GitHub integration)\n\n## Contributing\n\nSee [CONTRIBUTING.md](.github/CONTRIBUTING.md) for setup, branching, and contribution guidelines.\n\n## License\n\nMIT -- see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguild-agents%2Fguild","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguild-agents%2Fguild","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguild-agents%2Fguild/lists"}