{"id":45598343,"url":"https://github.com/sequenzia/agent-alchemy","last_synced_at":"2026-02-23T14:28:56.427Z","repository":{"id":334614989,"uuid":"1142060758","full_name":"sequenzia/agent-alchemy","owner":"sequenzia","description":"Agent Alchemy is a curated collection of plugins, apps, and extensions designed to elevate your agentic engineering workflows. Built for Claude Code and other AI coding agents, these tools help developers work smarter and ship faster.","archived":false,"fork":false,"pushed_at":"2026-02-22T22:31:18.000Z","size":4999,"stargazers_count":5,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-23T00:14:13.009Z","etag":null,"topics":["agent-skills","ai-agents","ai-coding","claude","claude-code","claude-code-plugin","claude-code-skills","claude-code-tasks","devloper-tools"],"latest_commit_sha":null,"homepage":"https://sequenzia.github.io/agent-alchemy","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/sequenzia.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","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-01-25T22:13:59.000Z","updated_at":"2026-02-22T22:31:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sequenzia/agent-alchemy","commit_stats":null,"previous_names":["sequenzia/claude-alchemy","sequenzia/agent-alchemy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sequenzia/agent-alchemy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sequenzia%2Fagent-alchemy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sequenzia%2Fagent-alchemy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sequenzia%2Fagent-alchemy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sequenzia%2Fagent-alchemy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sequenzia","download_url":"https://codeload.github.com/sequenzia/agent-alchemy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sequenzia%2Fagent-alchemy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29745432,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-23T07:44:07.782Z","status":"ssl_error","status_checked_at":"2026-02-23T07:44:07.432Z","response_time":90,"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":["agent-skills","ai-agents","ai-coding","claude","claude-code","claude-code-plugin","claude-code-skills","claude-code-tasks","devloper-tools"],"created_at":"2026-02-23T14:28:53.201Z","updated_at":"2026-02-23T14:28:56.422Z","avatar_url":"https://github.com/sequenzia.png","language":"TypeScript","readme":"# Agent Alchemy\n\nA plugin suite and developer toolkit that extends Claude Code into a structured development platform — from specs to tasks to autonomous execution.\n\n## What is Agent Alchemy?\n\nAgent Alchemy is an open-source toolkit for AI and software engineers who use Claude Code. It adds structured development workflows on top of Claude Code through six plugins, a real-time task manager, and a VS Code extension — all designed to work together as an integrated pipeline.\n\nEverything is built with Claude Code for Claude Code. The plugins are plain markdown — readable, editable, and version-controlled like any other code.\n\n## Components\n\n### Claude Code Plugins\n\nSix plugin groups providing 28 skills and 16 agents:\n\n| Plugin | Description |\n|--------|-------------|\n| **[SDD Tools](claude/sdd-tools/)** | Spec-Driven Development — turn ideas into specs, specs into tasks, and tasks into autonomous execution |\n| **[Dev Tools](claude/dev-tools/)** | Feature development, code review, architecture patterns, documentation, and changelog management |\n| **[Core Tools](claude/core-tools/)** | Codebase analysis, deep exploration with multi-agent teams, and language patterns |\n| **[TDD Tools](claude/tdd-tools/)** | Test-Driven Development — RED-GREEN-REFACTOR workflows, test generation, and coverage analysis |\n| **[Git Tools](claude/git-tools/)** | Conventional Commits automation |\n| **[Plugin Tools](claude/plugin-tools/)** | Plugin porting, adapter validation, ported plugin maintenance, and ecosystem health analysis |\n\n### [Task Manager](apps/task-manager/)\n\nA Next.js real-time Kanban dashboard for monitoring autonomous task execution. Tasks update live via filesystem watching and Server-Sent Events.\n\n![Claude Task Manager](./internal/images/claude-task-manager.png)\n\n**See more screenshots [screenshots](#screenshots) below**\n\n### [VS Code Extension](extensions/vscode/)\n\nSchema validation, YAML frontmatter autocomplete, and hover documentation for Claude Code plugin development.\n\n## Getting Started\n\n### Prerequisites\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed\n- Node.js \u003e= 18.0.0\n- pnpm \u003e= 8.0.0\n\n### Install Plugins\n\n```bash\n# Install from the Claude Code marketplace\nclaude plugins install agent-alchemy/agent-alchemy-sdd-tools\nclaude plugins install agent-alchemy/agent-alchemy-dev-tools\nclaude plugins install agent-alchemy/agent-alchemy-core-tools\nclaude plugins install agent-alchemy/agent-alchemy-git-tools\nclaude plugins install agent-alchemy/agent-alchemy-tdd-tools\nclaude plugins install agent-alchemy/agent-alchemy-plugin-tools\n```\n\n### Run Task Manager\n\n```bash\npnpm install\npnpm dev:task-manager\n# Open http://localhost:3030\n```\n\n### Build VS Code Extension\n\n```bash\ncd extensions/vscode\nnpm install\nnpm run build\nnpm run package\n```\n\n## Configuration\n\nPlugin behavior is configured via `.claude/agent-alchemy.local.md` — a markdown file with nested key-value pairs using `key: value` syntax. This file is not committed to version control.\n\n### File Format\n\n```markdown\n- deep-analysis:\n  - direct-invocation-approval: true\n  - invocation-by-skill-approval: false\n- execute-tasks:\n  - max_parallel: 5\n- author: Your Name\n- spec-output-path: specs/\n```\n\n### Settings Reference\n\n| Setting | Plugin | Default | Description |\n|---------|--------|---------|-------------|\n| `deep-analysis.direct-invocation-approval` | core-tools | `true` | Require user approval of the team plan when invoking `/deep-analysis` directly |\n| `deep-analysis.invocation-by-skill-approval` | core-tools | `false` | Require approval when deep-analysis is loaded by another skill (e.g., `/feature-dev`, `/codebase-analysis`) |\n| `execute-tasks.max_parallel` | sdd-tools | `5` | Maximum concurrent task-executor agents per wave. CLI `--max-parallel` takes precedence. Set to `1` for sequential execution |\n| `author` | sdd-tools | — | Author name for spec attribution and task metadata |\n| `spec-output-path` | sdd-tools | `specs/` | Default directory for spec file output |\n\n### Precedence\n\nSettings follow this precedence order (highest to lowest):\n1. CLI arguments (e.g., `--max-parallel`)\n2. `.claude/agent-alchemy.local.md` settings\n3. Built-in defaults\n\n## Architecture\n\nAgent Alchemy follows a **markdown-as-code** philosophy — \"prompts as software\" — where AI agent behaviors, workflows, and domain knowledge are defined entirely in Markdown with YAML frontmatter. There is no compilation step; the markdown files *are* the executable code, interpreted directly by Claude Code's runtime.\n\n### Three Interconnected Systems\n\n```\nPlugin Framework (claude/)        Task Dashboard (apps/task-manager/)\n  28 skills, 16 agents              Next.js 16 + TanStack Query\n  6 plugin groups                   Real-time Kanban via SSE\n  markdown-as-code                  Watches ~/.claude/tasks/\n         │                                    ▲\n         │  creates task JSON files           │ watches filesystem\n         └────────────────────────────────────┘\n\nVS Code Extension (extensions/vscode/)\n  Ajv YAML frontmatter validation\n  7 JSON schemas\n  Autocompletion + hover docs\n```\n\n### The SDD Pipeline\n\nThe flagship workflow chains four skills into an end-to-end development pipeline:\n\n```\n/create-spec  →  specs/SPEC-{name}.md        (adaptive interview)\n                      │\n/analyze-spec →  {name}.analysis.md + .html   (quality gate)\n                      │\n/create-tasks →  ~/.claude/tasks/*.json       (dependency-ordered decomposition)\n                      │\n/execute-tasks → Wave-based autonomous execution → Task Manager (real-time)\n```\n\n### Model Tiering\n\n| Tier | Model | Use Case |\n|------|-------|----------|\n| Reasoning | Opus | Synthesis, architecture, review, implementation |\n| Exploration | Sonnet | Parallel search, broad codebase exploration |\n| Simple | Haiku | Git commits, quick tasks |\n\n### Tech Stack\n\n| Component | Technology |\n|-----------|-----------|\n| Plugins | Markdown + YAML frontmatter |\n| Task Manager | Next.js 16, React 19, TanStack Query 5, Tailwind CSS v4, Chokidar 5 |\n| VS Code Extension | Ajv, esbuild |\n| Package Manager | pnpm (workspaces) |\n\n### Repository Structure\n\n```\nclaude/                          # Plugins (markdown-as-code)\n├── core-tools/                  # Analysis \u0026 exploration\n├── dev-tools/                   # Development lifecycle\n├── sdd-tools/                   # Spec-Driven Development\n├── tdd-tools/                   # Test-Driven Development\n├── git-tools/                   # Git automation\n└── plugin-tools/                # Plugin porting \u0026 ecosystem health\n\napps/task-manager/               # Real-time dashboard\n├── src/lib/fileWatcher.ts       # Chokidar -\u003e SSE\n├── src/app/api/events/route.ts  # SSE endpoint\n└── src/components/              # React UI\n\nextensions/vscode/               # Developer tooling\n├── src/frontmatter/             # YAML validation\n└── schemas/                     # JSON Schemas for plugin contracts\n```\n\n\n## Screenshots\n\n### Task Manager Kanban View\n![Claude Task Manager](./internal/images/claude-task-manager.png)\n\n### Tasks Generated from sdd-tools\n![Spec Tasks](./internal/images/tasks-generated-by-sdd-tools.png)\n\n### Single Task View with Dependencies, Test Cases and Acceptance Criteria\n![Task Detail View](./internal/images/task-in-task-manager.png)\n\n### Completed Tasks in Claude Code\n![Completed Tasks](./internal/images/completed-tasks-in-claude.png)\n\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsequenzia%2Fagent-alchemy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsequenzia%2Fagent-alchemy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsequenzia%2Fagent-alchemy/lists"}