{"id":50805176,"url":"https://github.com/danielvm-git/bigpowers","last_synced_at":"2026-06-27T02:04:34.517Z","repository":{"id":353669443,"uuid":"1220384784","full_name":"danielvm-git/bigpowers","owner":"danielvm-git","description":"59 agent skills for high-integrity, spec-driven, test-first software development by solo developers.  bigpowers provides a prescriptive, vertical-slice methodology for building software with AI agents (Claude Code, Gemini CLI, Cursor). It bridges the gap between raw LLM capabilities and professional engineering standards.","archived":false,"fork":false,"pushed_at":"2026-06-20T19:36:17.000Z","size":4554,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-20T20:20:52.611Z","etag":null,"topics":["ai-agents","automation","bmad","claude-code","clean-code","cursor-rules","devops","documentation-as-code","gemini-cli","productivity","software-engineering","solo-developer","spec-driven-development","tdd"],"latest_commit_sha":null,"homepage":"https://github.com/danielvm-git/bigpowers","language":"Shell","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/danielvm-git.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audit-code/HEURISTICS.md","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":"docs/AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-24T21:03:16.000Z","updated_at":"2026-06-20T19:42:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/danielvm-git/bigpowers","commit_stats":null,"previous_names":["danielvm-git/skills","danielvm-git/bigpowers"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/danielvm-git/bigpowers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielvm-git%2Fbigpowers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielvm-git%2Fbigpowers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielvm-git%2Fbigpowers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielvm-git%2Fbigpowers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielvm-git","download_url":"https://codeload.github.com/danielvm-git/bigpowers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielvm-git%2Fbigpowers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34835779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"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":["ai-agents","automation","bmad","claude-code","clean-code","cursor-rules","devops","documentation-as-code","gemini-cli","productivity","software-engineering","solo-developer","spec-driven-development","tdd"],"created_at":"2026-06-13T00:05:44.009Z","updated_at":"2026-06-27T02:04:34.511Z","avatar_url":"https://github.com/danielvm-git.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bigpowers — Best-in-Class Agentic Skills\n\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)\n![npm version](https://img.shields.io/npm/v/bigpowers.svg)\n![Skills](https://img.shields.io/badge/skills-70-brightgreen.svg)\n\n**70 agent skills for high-integrity, spec-driven, test-first software development by solo developers.**\n\n`bigpowers` provides a prescriptive, vertical-slice methodology for building software with AI agents (Claude Code, Gemini CLI, Cursor, pi). It bridges the gap between raw LLM capabilities and professional engineering standards.\n\nPublished on npm: [bigpowers@2.0.0](https://www.npmjs.com/package/bigpowers)\n\n---\n\n## 🚀 Quick Start\n\n### npm (recommended)\n\n```bash\n# One-shot setup — downloads, syncs artifacts, and links skills to your tools\nnpx bigpowers\n\n# Or install globally and run the setup command anytime\nnpm install -g bigpowers\nbigpowers\n```\n\nBoth commands sync skill artifacts and link them to Claude Code, Gemini CLI, and Cursor (see [Prerequisites](#-prerequisites)).\n\n### From source (contributors)\n\n```bash\ngit clone https://github.com/danielvm-git/bigpowers.git \u0026\u0026 cd bigpowers\nnpm install          # runs postinstall: sync + link\n# or manually:\nbash scripts/install.sh\nnpm run sync\n```\n\n---\n\n## 🛠 Prerequisites\n\n- **Bash**: Required for all scripts.\n- **Node.js**: v14+ (required for npm/npx).\n- **jq**: (Highly Recommended) Used for robust configuration of tool settings.\n- **AI Tools**: One or more of:\n  - [Claude Code](https://claude.ai/code)\n  - [Gemini CLI](https://github.com/google/gemini-cli)\n  - [Cursor](https://cursor.sh/)\n  - [pi](https://pi.dev/) — coding agent harness\n\n---\n\n## 🔄 Maintenance (Update \u0026 Uninstall)\n\n### Update\n\n**npm install:**\n\n```bash\nnpm update -g bigpowers\nbigpowers    # re-sync and refresh symlinks\n```\n\n**git clone:**\n\n```bash\ngit pull\nnpm run sync\n```\n\n*Install uses symlinks — re-running setup refreshes links without duplicating files.*\n\n### Uninstall\n\n**npm install:**\n\n```bash\nbash \"$(npm root -g)/bigpowers/scripts/install.sh\" --uninstall\nnpm uninstall -g bigpowers\n```\n\n**git clone:**\n\n```bash\nbash scripts/install.sh --uninstall\n```\n\n### Reinstall\n\n```bash\nnpx bigpowers\n# or, if installed globally:\nbigpowers\n```\n\n---\n\n## 🔌 pi Support\n\nbigpowers generates pi Agent Skills and prompt templates alongside Cursor and Gemini artifacts via `sync-skills.sh`.\n\n### Install as a pi package\n\n```bash\n# Clone and sync to generate pi artifacts\ncd bigpowers\nbash scripts/sync-skills.sh\n\n# Install from local path as a pi package\npi install .\n\n# Or install as a pi npm package (once published with pi-package keyword)\npi install npm:bigpowers\n```\n\n**What you get:**\n- **62 pi skills** in `.pi/skills/` — loaded automatically into pi's system prompt as `\u003cavailable_skills\u003e`\n- **62 pi prompt templates** in `.pi/prompts/` — slash commands like `/survey-context`, `/plan-work`\n- **pi package manifest** in `.pi/package.json` — enables `pi install` with auto-discovery\n\nSkills are loaded on-demand via progressive disclosure: only descriptions are always in context; the full SKILL.md loads when the agent reads it. Prompt templates expand in pi's editor with autocomplete.\n\n## 🔧 MCP Server (Model Context Protocol)\n\nbigpowers ships an MCP server that exposes all skills as callable MCP tools. Agents can discover and invoke skills dynamically instead of relying on a static system prompt.\n\n### Start the server\n\n```bash\nnode scripts/mcp-server.js\n```\n\n### Add to Claude Code\n\n```bash\nclaude mcp add bigpowers node /path/to/bigpowers/scripts/mcp-server.js\n```\n\nOr add manually to `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bigpowers\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/bigpowers/scripts/mcp-server.js\"]\n    }\n  }\n}\n```\n\n### Available MCP tools\n\n| Tool | Description |\n|------|-------------|\n| `bigpowers_list_skills` | List all 70 skills with name, description, phase. Optional `phase` filter. |\n| `bigpowers_get_skill` | Get full SKILL.md content for any skill by name. |\n| `bigpowers_search_skills` | Keyword/semantic search — returns ranked matches for a query. |\n| `bigpowers_get_state` | Get current `specs/state.yaml` (active flow, epic, step). |\n| `bigpowers_invoke_skill` | Get skill instructions with optional context for agent invocation. |\n\n---\n\n## 🏗 The v2.0.0 Lifecycle\n\nEvery project follows the **orchestrate-project 6-phase model** (full SOP: [`docs/WORKFLOW-SOP-v2.md`](docs/WORKFLOW-SOP-v2.md)):\n\n```\nONE TIME    seed-conventions  (CLAUDE.md, .claude/, .gemini/, agents/, skill sync)\n              ↓\nONCE/PROJECT orchestrate-project\n              │\n              ├─ Ph1 DISCOVER   survey-context, research-first, elaborate-spec\n              ├─ Ph2 ELABORATE  model-domain, grill-me, define-language, deepen-architecture\n              ├─ Ph3 PLAN       scope-work, slice-tasks, plan-work → release-plan.yaml (BCP baseline)\n              ├─ Ph4 BUILD      build-epic × N stories\n              │\n              │  Per story — 8-step build-epic cycle:\n              │   1. survey-context   ← stamps story_start in state.yaml\n              │   2. plan-work        ← [BCP N] tasks + verify: commands\n              │   3. kickoff-branch   ← worktree + feature branch\n              │   4. develop-tdd      ← RED → GREEN → REFACTOR\n              │   5. verify-work      ← UAT gate\n              │   6. audit-code       ← quality gate ≥ 94%\n              │   7. commit-message   ← Conventional Commits + semver\n              │   8. release-branch   ← land to main; writes story_end + cycle-times.yaml\n              │\n              ├─ Ph5 VERIFY     run-evals, verify-work (project-level)\n              └─ Ph6 RELEASE    semantic-release → v1.0.0 MVP tag\n```\n\n**Semver:** projects start at `0.0.0-β`; each `feat:` story → minor bump; developer declares MVP → `1.0.0`.\n\n**BCP accounting:** every task labeled `[BCP N]`; story total in `state.yaml`; BCP/hr logged to `specs/metrics/cycle-times.yaml`.\n\n**next_skill signaling:** each critical-path skill writes `handoff.next_skill` to `state.yaml`. Call `survey-context` after any interruption to resume exactly where you left off.\n\n---\n\n## 📖 Hierarchy of Truth\n\n| Level | Document | Responsibility |\n| :--- | :--- | :--- |\n| **Vision** | `docs/PRINCIPLES.md` | Philosophical foundations and evolution. |\n| **Context** | `specs/tech-architecture/TECH_STACK_LATEST.md` | Tech stack, architecture, and domain notes. |\n| **Scope** | `specs/product/SCOPE_LATEST.yaml` | In-scope / out-of-scope and success criteria. |\n| **Vision** | `specs/product/VISION_LATEST.yaml` | North star and initiative success criteria. |\n| **Decisions** | `specs/adr/` | Architectural Decision Records (irreversible choices). |\n| **Roadmap** | `specs/release-plan.yaml` + `specs/epics/` | WSJF-prioritized epics and stories with BCP baseline. |\n| **Current** | `specs/state.yaml` | Session flow, active epic, `handoff.next_skill`, timestamps. |\n| **Metrics** | `specs/metrics/cycle-times.yaml` | Per-story BCPs, cycle minutes, BCP/hr (v2.0.0). |\n| **Index** | `SKILL-INDEX.md` | Canonical list of all active skills. |\n| **Style** | `CONVENTIONS.md` | Coding, testing, and naming standards. |\n\n---\n\n## 📁 Project Structure\n\n- `scripts/`: Installation, syncing, and compliance tools.\n- `specs/`: YAML cockpit — `state.yaml`, `release-plan.yaml`, `epics/`, `execution-status.yaml`, `requirements/`.\n- `specs/metrics/`: Cycle-time ledger (`cycle-times.yaml`) — per-story BCPs, timestamps, BCP/hr (v2.0.0).\n- `dashboard/`: Live monitoring tool — TUI (`npm run dashboard`) and web (`npm run dashboard:web`, port 7742).\n- `docs/`: Guides including `WORKFLOW-SOP-v2.md` (full SDLC SOP) and `using-bigpowers.md`.\n- `docs/references/`: Theoretical foundations (Uncle Bob, Ousterhout, Karpathy, etc.).\n- `[skill-name]/`: Source files for each of the 70 skills.\n\n---\n\n## 🤝 References \u0026 Credits\n\n`bigpowers` stands on the shoulders of giants. It integrates patterns from:\n- **Akita**: Architectural patterns.\n- **BMAD**: Bold, Minimal, Actionable, Durable documentation.\n- **Clean Code**: Robert C. Martin (Uncle Bob).\n- **A Philosophy of Software Design**: John Ousterhout.\n- **GSD (Get Stuff Done)**: Pragmatic workflow frameworks.\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n*“Simplicity is the ultimate sophistication, but integrity is the ultimate requirement.”*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielvm-git%2Fbigpowers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielvm-git%2Fbigpowers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielvm-git%2Fbigpowers/lists"}