{"full_name":"buildermethods/agent-os","owner":"buildermethods","name":"agent-os","shard":"1","url":"https://github.com/buildermethods/agent-os","description":"Agent OS is a system for injecting your codebase standards and writing better specs for spec-driven development.","homepage":"https://buildermethods.com/agent-os","topics":[],"tag_pages":[],"language":"Shell","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/221219453?v=4","created_at":"2025-07-16T21:28:59Z","pushed_at":"2026-10-07T04:18:58Z","metrics":{"stars":5608,"forks":833,"watchers":103,"issues":60,"prs":104,"releases":12,"issues_open":0,"issues_closed":60,"prs_open":1,"prs_closed":69,"prs_merged":34,"discussions":187},"growth":{"day":{"stars":3,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[5591,5595,5598,5600,5603,5605,5608],"forks":[831,832,832,833,833,833,833],"watchers":[null,103,103,103,103,103,103],"issues_open":[null,0,0,0,0,0,0],"prs_open":[null,1,1,1,1,1,1]},"boards":{},"same_owner":[],"issues":[],"discussions":[{"number":354,"title":"How should /shape-spec handle decisions that conflict with project standards?","comments":1,"category":"Q&A","created_at":"2026-10-07T11:06:49Z"},{"number":349,"title":"Not liking the direction of the project","comments":1,"category":"General","created_at":"2026-08-18T08:35:20Z"},{"number":346,"title":"New community skill: audit and critique your Agent OS profiles from inside Claude","comments":0,"category":"Show and tell","created_at":"2026-05-14T13:37:41Z"},{"number":345,"title":"CRLF line endings in shell scripts break WSL2/Linux execution","comments":1,"category":"Bugs","created_at":"2026-05-08T01:48:26Z"},{"number":344,"title":"Feature idea: /analyze-spec command for pre-implementation spec validation","comments":0,"category":"Ideas","created_at":"2026-05-08T00:38:38Z"},{"number":343,"title":"Is Agent OS being maintained?","comments":1,"category":"Q&A","created_at":"2026-04-14T10:18:07Z"},{"number":342,"title":"Legacy friendly contextualisation: Describe -> Discover -> Unify -> Spec","comments":0,"category":"Ideas","created_at":"2026-04-09T07:55:55Z"},{"number":341,"title":"Project install script not working (Version 3.0 - 2026-01-20)","comments":1,"category":"Bugs","created_at":"2026-03-25T21:35:53Z"}],"latest_release":{"name":"Agent OS 3.0","tag":"v3.0.0","published_at":"2026-01-20T17:26:20Z","body":"Agent OS v3 is a major release that refocuses the framework on what it does best—establishing and injecting standards—while deferring to modern AI tools for the parts they now handle better.\r\n\r\n**[Full documentation →](https://buildermethods.com/agent-os)** | **[Migration guide →](https://buildermethods.com/agent-os/migration)**\r\n\r\n## Why the change?\r\n\r\nAI coding tools have evolved significantly since Agent OS's original release in mid-2025. Claude Code's plan mode, extended thinking, and improved models now handle much of the scaffolding that earlier versions of Agent OS provided.\r\n\r\nIt doesn't make sense to reinvent these core functions, which are much better handled by the core tools than 3rd-party frameworks like Agent OS:\r\n\r\n- **Spec writing** — Now best handled using Plan mode.\r\n- **Task breakdown** — Claude Code and other tools automatically create and track todo lists.\r\n- **Implementation orchestration** — Frontier models manage and delegate tasks on their own now (but you can still direct them to use subagents as you like).\r\n\r\nAgent OS v3 focuses more squarely on the original problems it set out to solve:\r\n\r\n- **Establishes standards** — A system to align your agents to how you build products and your product's mission.\r\n- **Injects standards smartly** — Deploys the right standards at the right time, without reinventing your workflow.\r\n- **Enhances spec-driven development** — Helps you create stronger, more aligned specs.\r\n\r\n## What's different in v3?\r\n\r\n### Standards\r\n\r\nThe concept and structure of standards is unchanged. But v3 introduces new tools for creating and maintaining them:\r\n\r\n- `/discover-standards` — Lets the agent surface, suggest, and create standards from your codebase.\r\n- `/inject-standards` — Injects standards into any context: conversations, plans, Claude Skills, or anywhere your agent needs them. It automatically detects which standards are relevant via the new `index.yml` file.\r\n- **Sync script** — Syncs your project's standards back to your base profiles.\r\n\r\n### Specs\r\n\r\nThe structure of specs is unchanged—your `agent-os/specs/` folders remain intact.\r\n\r\nWhat's new is how specs are created. Instead of Agent OS commands handling spec writing, we defer to **Plan Mode** in Claude Code (or Cursor, or any agent with plan mode). This is the industry-standard approach to spec-driven development in 2026+.\r\n\r\nAgent OS enhances plan mode with `/shape-spec`, which prompts targeted questions that consider your standards and product mission—resulting in better, more aligned specs (which get written via Plan mode). It also saves your plan into your Agent OS spec folder automatically.\r\n\r\n### Product planning\r\n\r\nThe product planning phase from v2 is still here, producing the same files:\r\n\r\n- `agent-os/product/mission.md`\r\n- `agent-os/product/roadmap.md`\r\n- `agent-os/product/tech-stack.md`\r\n\r\nIt's simpler, smarter, and uses the AskUserQuestion tool for a smoother experience.\r\n\r\n### Profiles\r\n\r\nProfiles are still here for managing different standards sets across project types.\r\n\r\nInheritance is simpler in v3—now defined in your main `config.yml` instead of separate `profile-config.yml` files. V3 also adds a sync script to push new standards from a project back to your base profiles.\r\n\r\n### Subagents & orchestration\r\n\r\nThe implementation and orchestration phases from v2 have been retired. Today's frontier models handle spec implementation well on their own—this is the recommended approach in 2026+.\r\n\r\nWhile Agent OS no longer installs subagents, you can create your own. Use `/inject-standards` to bake your standards into subagents, Claude Skills, custom commands, or any prompt.\r\n\r\n## Is it backward compatible?\r\n\r\n**Yes and no.**\r\n\r\n**Your content stays the same.** Your standards, specs, and product docs use the same format. They transfer directly to v3 without modification.\r\n\r\n**Commands and scripts are new.** The installation and updating process is much simpler in v3, but the commands themselves are different.\r\n\r","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}