{"id":"c412faf3-29cd-4775-9dc7-b3343abd15f3","slug":"organism","kind":"skill","name":"organism","summary":"An ecosystem of AI intelligences — Brain, Spine, Hands, Gut — that work side by side in real-time, not sequentially. Built for 2026 reality where AI is fast but thinking still matters. Keeps you focus","owner":"abryfs","repoUrl":"https://github.com/abryfs/organism","license":"MIT","licenseTier":"permissive","trust":"community","stars":6,"match":null,"fewStars":false,"format":"skill","createdAt":"2026-03-23T06:14:23.000Z","addedAt":"2026-10-21T17:03:09.862Z","logoUrl":"https://avatars.githubusercontent.com/u/69842068?u=0070d14d5d57ff2b4c631616b5b7b7763e5e4a24&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-25T20:02:17.806Z","sample":false,"url":"https://conduits.dev/tools/organism","language":"Shell","transports":["stdio"],"install":{"npm":"organism-ai"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Organism\n\nThe nervous system for autonomous engineers at lean companies.\n\nOne skill. Role-adaptive. Serves:\n\n- **Solo founders** building their own company end-to-end (all 9 organs active)\n- **Founding engineers** owning outcomes at a lean startup (core 4 + on-demand specialists)\n- **IC engineers** shipping features on a larger team (discipline + plugin coordination)\n\nAI made building cheap. Everything else — picking the right tool, writing\nthe right test, shipping without stepping on teammates — is still work.\nOrganism handles the everything else.\n\n## What It Actually Is\n\nOrganism is a CLAUDE.md file, a SKILL.md entry point, 3 bin scripts, 2 hooks,\na systems registry, and 39 organ skills. Opinionated prompt engineering\napplied as a coordination protocol that fires at every task. When you\ninstall it, your Claude Code sessions gain:\n\n- **One entry point** — `/organism` detects role, reads project context, picks the right tool\n- **Role-adaptive behavior** — founders, founding engineers, and ICs each get a different default organ map\n- **Smart context bootstrap** — reads CLAUDE.md, `.cursorrules`, PRDs, roadmaps, READMEs; never forces a NORTH-STAR.md on existing projects\n- **Full plugin coordination** — GSD, Superpowers, gstack, context7, serena, feature-dev, qodo-skills, frontend-design, ralph-loop, claude-md-management, skill-creator all wired into the 7-step protocol\n- **Companion awareness** — Cursor, Bugbot, CodeRabbit, Greptile, Qodo detected and organism dims duplicate work\n- **A coordination protocol** where organs hand off to each other with gates between them\n- **100 named pitfalls** — documented failure patterns from startup history (founder-mode by default; on-demand in engineer roles)\n- **Discipline with teeth** — Spine blocks untestable plans, tests gate evidence before \"done,\" hook scope-infers instead of block-all\n\n### The Three Sides\n\n**Build Side** (the product) — exists since v0.1:\n- **Gut** — Market instinct. Demand research, competitive intelligence, user interviews, feedback processing. \"Is this the right thing to build?\"\n- **Brain** — Memory and planning. State tracking, phases, roadmap, lifecycle. \"What's the plan?\"\n- **Spine** — Integrity. TDD enforcement, evidence requirements, quality gates. \"Is it solid?\"\n- **Hands** — Touch. Browser QA, visual verification, deployment. \"Does it work?\"\n\n**Business Side** (the company) — new in v0.4:\n- **Voice** — How you tell the world. Marketing, positioning, outreach, pitch decks, storytelling. Turns internal understanding into language that lands with real people.\n- **Legs** — How you find people. Distribution strategy, first users, growth channels, go-to-market. Goes where the users are.\n- **Blood** — How you survive. Revenue path, pricing, unit economics, fundraising, investors. No blood, no organism.\n- **Heart** — Who builds this with you. First hires, culture, values, team structure, compensation. Not just recruitment — the kind of company you're building.\n\n**Founder Side** (the person) — new in v0.4:\n- **Eyes** — What you see clearly. Outward: find people, investors, warm paths, opportunities. Inward: cognitive biases, self-deception, pivot timing, burnout detection. The organ that sees what you don't want to see.\n\n### The Pitfall Layer\n\nEvery organ carries the documented history of failures in its domain. Not generic advice — specific, named patterns that have killed startups.\n\n- **Voice** checks: \"You're describing features instead of benefits. That's The Feature Dump Pitch — the #1 reason investor decks fail.\"\n- **Legs** checks: \"You're scaling before PMF. 74% of startups that scale prematurely fail.\" (Startup Genome Report)\n- **Blood** checks: \"Your CAC exceeds your LTV. That's The Dollar Bill Problem — you're paying people to be customers.\" (David Sacks)\n- **Heart** checks: \"You're hiring to avoid doing sales yourself. That's the Delegation-of-Discomfort Hire.\" (a16z)\n- **Eyes** checks: \"You've pivoted 3 times in 2 weeks. That's Shiny Object Syndrome, not iteration.\" (Fred Brooks)\n\n100 pitfalls total. Each fires as Block (stop everything), Warn (flag and continue), or Note (log for awareness). The founder always decides — but the organism never stays silent when it recognizes a pattern.\n\nOrganism coordinates the Claude Code plugin ecosystem. Each contributes to\none or more protocol steps:\n\n- **[GSD](https://github.com/coleam00/get-shit-done-cc)** (50+ commands) — project lifecycle, planning, state, verification, debugging, shipping\n- **[Superpowers](https://github.com/anthropics/claude-plugins-official)** — TDD, systematic debugging, brainstorming, plans, code review, git worktrees, parallel agents\n- **[gstack](https://github.com/garrytan/gstack)** — YC office hours, plan reviews, browser QA, ship/deploy/canary, safety guardrails, anti-slop\n- **[Context7](https://context7.com)** (MCP) — live library/framework docs at planning and implementation steps\n- **[Serena](https://github.com/oraios/serena)** (MCP) — semantic code analysis, symbol-level edits, precise review\n- **feature-dev** — specialized subagents (code-architect, code-explorer, code-reviewer) for deep-context feature work\n- **qodo-skills** — rule loading before plan; PR feedback resolution after review\n- **frontend-design** — production-grade UI generation at UI-heavy build steps\n- **ralph-loop** — parallel chunk execution for independent tasks\n- **claude-md-management** — CLAUDE.md quality audit at bootstrap and health-check steps\n- **skill-creator** — meta-loop when organism itself needs improvement\n\nIf you have Cursor, Bugbot, CodeRabbit, Greptile, or Qodo configured in\nyour repo, organism detects them and dims overlapping steps — no\nduplicate reviews, no double enforcement.\n\n## Install\n\n**Requirements:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Git](https://git-scm.com/)\n\n### Step 1: Install on your machine\n\nOpen Claude Code and paste this. Claude does the rest.\n\n> Install organism: run **`git clone https://github.com/abryfs/organism.git ~/.claude/skills/organism && cd ~/.claude/skills/organism && ./setup`** then add an \"organism\" section to CLAUDE.md that says to use /organism as the main entry point for all work, listing available skills from the Build Side (/organism:north-star, demand, competitive, interview, feedback, reality-check, user-lens, health-check, sync-check, split), Business Side (/organism:voice, position, pitch, outreach, story, legs, channels, launch, first-users, growth, blood, pricing, unit-economics, fundraise, investors, financial-model, heart, culture, hire, comp, team-plan), and Founder Side (/organism:eyes, find, scan, reflect, premortem, pivot-check, briefing). Then check if GSD, Superpowers, and gstack are installed — if any are missing, install them: GSD via `npx get-shit-done-cc`, Superpowers via `/plugins` then enable superpowers, gstack via `git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup`. All three are required for the build side.\n\n### Step 2: Add to your repo so teammates get it (optional)\n\n> Add organism to this project: run **`cp -Rf ~/.claude/skills/organism .claude/skills/organism && rm -rf .claude/skills/organism/.git`** then add an \"organism\" section to this project's CLAUDE.md listing all available skills and noting that GSD, Superpowers, and gstack are required for the build side. If organism skills aren't working, run `cd .claude/skills/organism && ./setup`.\n\n### Or install from npm\n\n```bash\nnpx organism-ai\n```\n\nAfter install, type `/organism`. It detects your project state and picks the right mode automatically. No other commands needed to start.\n\n### Update\n\nAuto-updates on every session start. To update manually:\n\n```bash\ncd ~/.claude/skills/organism && git pull origin main\n```\n\n## How It Works\n\n### Four Modes\n\n**Onboard.** You have an existing codebase but no organism yet. The organism maps your code with 7 parallel explorers, reads your README and docs, infers who you're building for and why, then asks you to confirm or correct. Takes ~10 minutes.\n\n**Birth.** You're starting from scratch. The organism walks you through defining your product: who it's for, what pain it solves, whether demand exists, who the competitors are, and what to build first. Takes ~15-20 minutes.\n\n**Pulse.** You're returning to a project the organism already knows. It reads your state, tells you where things stand, states the focus, and recommends the next step. Takes 30 seconds.\n\n**Work.** You give a task. The coordination protocol runs — every organ that's relevant participates. Gates block shortcuts. Health checks summarize what happened.\n\n### How Tasks Flow Through the Organs\n\nThe new organs work in two modes: **participating** in build tasks, or **leading** their own workflows.\n\n**Mode 1: Participating in build tasks**\n\nWhen you say \"build the pricing page,\" the build protocol runs. The new organs add checks at relevant steps — they don't add new steps:\n\n```\nStep 1 (Gut):    Does this serve the focus?\n                 Blood: Do we have pricing research? What should we charge?\n                 Voice: Do we have positioning? The page needs messaging.\n                 Eyes:  Are we building this because users need it, or avoiding sales?\n\nStep 2 (Brain):  Plan the tasks.\n                 Legs:  Can users find this page? What's the path from discovery?\n                 Blood: What does comparable pricing look like?\n\nSteps 3-5:      Build side runs normally. Spine gates, Hands builds, Spine verifies.\n\nStep 6 (Gut):    Does this serve real users?\n                 Voice: Would the persona understand this page?\n                 Legs:  How does a user get here?\n\nStep 7:          Health check — all relevant organs contribute.\n                 Blood: Pricing health alongside product health.\n                 Eyes:  Founder state — any patterns to flag?\n```\n\nNew organs only speak when they have something relevant to say. Blood stays silent during a bug fix. Legs stays silent during a database migration. The tier controls visibility:\n\n- **Quick**: Only Block-severity pitfalls surface from new organs.\n- **Standard**: One-line micro-outputs at relevant steps.\n- **Full**: Full analysis from every relevant organ.\n\n**Mode 2: Leading their own workflows**\n\nWhen the task isn't building, a new organ takes the lead:\n\n| You say... | Lead organ | Build organs support |\n|---|---|---|\n| \"How should we price this?\" | Blood | Voice writes pricing page copy, Legs checks channel fit |\n| \"I need users\" | Legs | Voice drafts content, Eyes finds people |\n| \"I need to raise money\" | Blood | Voice preps the pitch, Eyes researches investors |\n| \"Should I hire?\" | Heart | Blood checks affordability, Eyes checks if it's delegation-of-discomfort |\n| \"Am I doing the right thing?\" | Eyes | All organs contribute their perspective |\n| \"How do I explain this product?\" | Voice | Gut provides persona, Legs identifies the channel |\n\nSame coordination protocol. Different organ leads. Gates still fire — Spine still requires evidence, Gut still checks alignment. The new organs extend discipline to new domains.\n\n### Health Checks\n\nAfter meaningful work, the organism delivers a pulse. Each organ owns its section:\n\n> **Focus:** Pricing strategy for launch *(Gut)*\n>\n> **Built:** 3-tier pricing page with annual/monthly toggle. 5 tests passing. *(Hands)*\n>\n> **What this means:** Users can self-select based on team size. Covers the \"skeptical buyer\" persona — free trial, no credit card. *(Brain)*\n>\n> **Pricing:** $29/$79/$199 tiers. Comparable products charge $39-149. LTV:CAC at 4.2:1. Runway: 14 months. *(Blood)*\n>\n> **Distribution:** Pricing page is linked from homepage but not from the primary acquisition channel (HN posts). Add a CTA. *(Legs)*\n>\n> **Next:** Launch prep — first 10 users via manual outreach. *(Brain)*\n>\n> **Quality:** Completeness 8/10. Tests passing. 0 gates overridden. *(Spine)*\n>\n> **Founder state:** 3rd week of focused execution. No drift detected. No burnout signals. *(Eyes)*\n>\n> **Parked:** Dark mode, enterprise tier. *(Gut)*\n\n### Adaptive Tiers\n\n| Tier | When | What you see |\n|------|------|-------------|\n| **Quick** | Bug fixes, small changes | Only gates and Block-severity pitfalls surface. |\n| **Standard** | Features, user-facing, multi-file | Each organ shows a micro-artifact (3-5 lines). |\n| **Full** | Architecture, launches, pivots | Full organ analysis. Agent Teams for parallel work. |\n\n### Saying No\n\nDefault answer to new ideas is **no** unless they serve the focus. Gut catches off-focus work. Legs catches features nobody can find. Blood catches features that don't pay for themselves. Eyes catches the founder avoiding hard problems by building easy ones. Only the founder can change the focus.\n\n## The Rules\n\n### Build Rules\n1. **Gut before Brain.** Every task gets an alignment check. Off-focus work triggers the Gut Alignment Gate.\n2. **Design before build.** Brain plans. What changes, who's affected, what breaks.\n3. **Test before code.** Spine gates the plan. Failing test first. Code before test = delete.\n4. **Root cause before fix.** Investigate, don't patch. 3 failed fixes = rethink.\n5. **Evidence before \"done.\"** Spine verifies. Run tests, read output, attach it.\n6. **Reality before ship.** Gut checks against real users. Passing tests is necessary, not sufficient.\n\n### Business Rules\n7. **Price before build.** Blood checks unit economics before features ship. Building something unprofitable is worse than building nothing.\n8. **Distribution before polish.** Legs checks: can users find this? If not, distribution work comes before feature work.\n9. **Position before communicate.** Voice requires positioning artifacts before drafting copy. Messaging without strategy is noise.\n10. **Culture before hire.** Heart blocks hiring until a culture document exists. Culture by accident is a pitfall.\n11. **PMF before scale.** Heart and Blood gate scaling decisions. Every hire and every dollar of spend requires PMF evidence.\n\n### Founder Rules\n12. **Clarity before action.** Eyes runs before major decisions. Pre-mortems, kill criteria, bias checks.\n13. **Sell before build more.** Eyes flags \"building to avoid selling\" — the #1 technical founder trap.\n14. **Rest before collapse.** Eyes tracks burnout signals. Shadow burnout kills founders who think they're fine.\n\n### Always Rules\n15. **Recommend, don't interrogate.** Best option with reasoning.\n16. **Keep the founder in the headspace.** Health checks after meaningful work. All organs contribute.\n17. **Say no by default.** Only the focus gets built. Everything else gets parked.\n18. **Every gate override is logged.** Patterns reveal where judgment needs adjusting.\n19. **No slop ships.** Spine checks code, Voice checks copy. AI patterns get rewritten.\n20. **Never forget what we're building.** NORTH-STAR.md at session start. Every decision traces back.\n\n## Skills\n\n### Build Side (the product)\n\n| Skill | What it does |\n|-------|-------------|\n| `/organism` | Main entry point. Auto-detects Birth/Onboard/Pulse/Work mode. |\n| `/organism:north-star` | Define product purpose, users, and success metric |\n| `/organism:demand` | Research real demand: forums, reviews, trends, competitor traction |\n| `/organism:competitive` | Competitor landscape scan and positioning analysis |\n| `/organism:interview` | Prepare user interview guides, capture insights |\n| `/organism:feedback` | Ingest user feedback → product decisions |\n| `/organism:reality-check` | 5 filters: user, market, technical, business, time |\n| `/organism:user-lens` | Test from 5 user perspectives |\n| `/organism:health-check` | On-demand product status pulse |\n| `/organism:sync-check` | Verify docs, maps, and code are consistent |\n| `/organism:split` | Spawn 3-agent team for critical work |\n\n### Business Side (the company)\n\n| Skill | Organ | What it does |\n|-------|-------|-------------|\n| `/organism:voice` | Voice | Entry point: positioning, pitch, outreach, or story |\n| `/organism:position` | Voice | Positioning exercise (April Dunford 10-step) |\n| `/organism:pitch` | Voice | Investor pitch materials, tailored per investor |\n| `/organism:outreach` | Voice | Targeted outreach: users, investors, partners, hires |\n| `/organism:story` | Voice | Product narrative (StoryBrand, SUCCESs) |\n| `/organism:legs` | Legs | Entry point: assess distribution state, detect growth stage |\n| `/organism:channels` | Legs | Research and rank channels (Bullseye Framework, ICE scoring) |\n| `/organism:launch` | Legs | Plan a launch: ProductHunt, HN, Reddit, IH |\n| `/organism:first-users` | Legs | Zero-to-ten playbook (Lenny's 7 strategies) |\n| `/organism:growth` | Legs | Growth loops, channel optimization, scaling strategy |\n| `/organism:blood` | Blood | Entry point: financial health, pricing, unit economics |\n| `/organism:pricing` | Blood | Pricing exercise (Van Westendorp, Gabor-Granger) |\n| `/organism:unit-economics` | Blood | CAC, LTV, margins, burn multiple with benchmarks |\n| `/organism:fundraise` | Blood | Fundraising strategy, term sheet review, dilution modeling |\n| `/organism:investors` | Blood | Research investors: portfolio, thesis, warm paths |\n| `/organism:financial-model` | Blood | Three-statement model, runway, Default Alive/Dead |\n| `/organism:heart` | Heart | Entry point: team state assessment, readiness gate |\n| `/organism:culture` | Heart | Define culture and values (Netflix/Stripe/5-word frameworks) |\n| `/organism:hire` | Heart | Plan a hire: role, comp, channels, interview design |\n| `/organism:comp` | Heart | Compensation benchmarks for a specific role |\n| `/organism:team-plan` | Heart | Team structure for next 6-12 months |\n\n### Founder Side (the person)\n\n| Skill | Direction | What it does |\n|-------|-----------|-------------|\n| `/organism:eyes` | Both | Entry point: scan outward or reflect inward |\n| `/organism:find` | Outward | Find a specific person and the warm path to them |\n| `/organism:scan` | Outward | Opportunities: grants, accelerators, partnerships |\n| `/organism:briefing` | Outward | Deep background dossier before a meeting |\n| `/organism:reflect` | Inward | Decision review, bias detection, pattern surfacing |\n| `/organism:premortem` | Inward | \"Assume this failed. Why?\" + kill criteria |\n| `/organism:pivot-check` | Inward | Pivot, persevere, or quit — evidence-based |\n\nSkills run as part of the coordination protocol during work. You don't invoke them. The organism does. The commands above are explicit overrides for when you want to trigger something specific.\n\n## Validation & Hooks\n\nThe organism ships with real enforcement, not just instructions.\n\n### Hooks\n\n| Hook | Event | What it does |\n|------|-------|-------------|\n| `hooks/session-start.sh` | SessionStart | Validates NORTH-STAR.md, checks focus, detects stale research, validates systems.json, runs auto-update |\n| `hooks/post-edit.sh` | PostToolUse (Edit/Write) | Blocks production code edits when protocol steps 1-3 aren't complete. Exit code 2 with decision:block message. |\n\nHooks install automatically during `./setup`. They merge into your existing `~/.claude/settings.json` without overwriting other hooks.\n\n### Protocol Enforcement\n\nThe coordination protocol is enforced by real hooks, not just instructions:\n\n```bash\n# Protocol blocks code edits until Gut, Brain, Spine run\nprotocol.sh start \"task description\" standard\nprotocol.sh mark gut-filter \"alignment result\"\nprotocol.sh mark brain-plan \"3 tasks\"\nprotocol.sh mark spine-gate \"approved\"\n# NOW code edits are allowed\n\n# Learning loop — after shipping to users\noutcomes.sh log \"feature\" --predicted \"what you expected\" --actual \"what happened\"\n```\n\n41 tests verify the enforcement works. See `test/` directory.\n\n### Validation\n\n```bash\n~/.claude/skills/organism/bin/validate.sh /path/to/project\n```\n\nChecks: NORTH-STAR.md exists with required sections, research isn't stale, .planning/ state is healthy. Exit codes: 0 (pass), 1 (warnings), 2 (errors).\n\n## How the Systems Map to Organs\n\nNo system is locked to one organ. The organism routes the right skill from the right system to the right protocol step.\n\n| | Gut | Brain | Spine | Hands |\n|---|---|---|---|---|\n| **GSD** | Requirement tracing, backlog | State, phases, roadmap, workstreams | Verification loops, gap closure | Codebase mapping, debugging |\n| **Superpowers** | Brainstorming hard-gates | Planning with granularity, worktrees | TDD enforcement, root cause, code review | Subagent-driven dev, parallel dispatch |\n| **gstack** | Office hours, CEO review | Plan-eng-review, retro | Code review, Codex, stop-slop, safety | Browser QA, design review, ship, canary |\n\nThe business and founder organs (Voice, Legs, Blood, Heart, Eyes) use Claude Code's built-in capabilities — WebSearch for research, WebFetch for data, Read/Write for artifacts, AskUserQuestion for decisions. No additional systems required, though MCP servers can extend them.\n\n## Building in 2026\n\n- Ship an MVP in days, not months. Longer means overbuilding.\n- Automate from day 1. AI makes automation the starting point.\n- Your first employees are AI agents. Scale with agents before hiring humans.\n- Moat comes from proprietary data, user trust, and iteration speed. Not clever code.\n- Move fast and TEST things. AI makes testing as fast as building.\n- Talk to real users. AI didn't change human psychology.\n- **Price before you build.** Unit economics that don't work at 10 users won't work at 10,000.\n- **Distribute before you polish.** The best product nobody finds is the same as no product.\n- **Know when to quit.** When building costs near zero, the signal to stop disappears. Set kill criteria.\n\n## Requirements\n\n- [Claude Code](https://claude.ai/claude-code) (any plan: Pro, Max, or API)\n- [GSD](https://github.com/coleam00/get-shit-done-cc): planning, state, lifecycle\n- [Superpowers](https://github.com/anthropics/claude-plugins-official): TDD, debugging, code review\n- [gstack](https://github.com/garrytan/gstack): browser QA, reviews, shipping\n- For `/organism:split`: Claude Code v2.1.32+ with `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`\n\nGSD, Superpowers, and gstack are required for the build side. The setup script checks for all three and guides you through installing any that are missing. Business and founder organs work without additional systems.\n\n## Philosophy\n\nAI writes code fast. Organism makes sure you don't waste that speed.\n\nNot just on building the wrong thing — on selling it wrong, pricing it wrong, funding it wrong, hiring wrong, and fooling yourself about all of the above.\n\nNine organs enforce the questions that matter across the full founder lifecycle. Gut asks \"who is this for?\" Blood asks \"can you make money?\" Legs asks \"can users find it?\" Voice asks \"can you explain it?\" Heart asks \"who builds it with you?\" Eyes asks \"are you seeing clearly?\" Brain plans it. Spine enforces it. Hands verify it.\n\nThe coordination protocol runs on every task. Gates between organs block shortcuts. 100 named pitfalls catch patterns before they become fatal. The founder stays focused on decisions. The organism stays focused on discipline.\n\n## Contributing a System\n\nThe organism is open to any repo that improves the founder-engineer workflow. GSD, Superpowers, and gstack are the core build-side systems, but they're not the only ones. If your repo strengthens any organ — build, business, or founder — it can become part of the organism.\n\n### What qualifies\n\nA system qualifies if it:\n1. **Provides skills or commands** that serve one or more organ functions\n2. **Can be detected** automatically (directory exists, command available, config file present)\n3. **Works with Claude Code** (skill files, MCP server, CLI tool, or plugin)\n4. **Doesn't duplicate without improving.** If it overlaps with an existing system, it should be measurably better.\n\n### How to add your system\n\n**1. Register it in `systems.json`**\n\n```json\n{\n  \"your-system\": {\n    \"name\": \"Your System\",\n    \"detect\": [\"~/.claude/skills/your-system\", \"command:your-cmd\"],\n    \"repo\": \"https://github.com/you/your-system\",\n    \"install\": \"git clone ... && ./setup\",\n    \"skills\": { \"category\": [\"skill-1\", \"skill-2\"] },\n    \"protocol_steps\": {\n      \"gut-filter\": [\"skill-that-helps-alignment\"],\n      \"spine-gate\": [\"skill-that-enforces-quality\"]\n    }\n  }\n}\n```\n\n**2. Map your skills to protocol steps**\n\n| Step | Function | Your system helps here if it... |\n|------|----------|-------------------------------|\n| Step 1: Gut Filter | Alignment, market context | Validates demand, checks competition, assesses fit |\n| Step 2: Brain Plan | Planning, state, task breakdown | Manages state, creates plans, structures work |\n| Step 3: Spine Gate | Testability, design review | Enforces TDD, reviews architecture, checks quality |\n| Step 4: Hands Build | Implementation, TDD, QA | Writes code, runs tests, verifies in browser |\n| Step 5: Spine Verify | Evidence, code review, QA | Reviews diffs, runs QA, scores quality |\n| Step 6: Gut Reality | User grounding | Tests from user perspective, validates against persona |\n| Step 7: Health Check | Status, metrics | Provides progress data, metrics |\n\n**3. Add detection to setup, update CLAUDE.md routing table, submit a PR.**\n\n### MCP servers\n\nMCP servers extend the organism through tool access. They get registered in the `systems` map of `systems.json` (with `detect: [\"mcp:...\"]`) and are detected by checking Claude Code's MCP configuration.\n\n### Guidelines\n\n- **Don't fight existing systems.** Fill gaps or be measurably better at the overlap.\n- **Map to protocol steps.** Every skill should be routable to at least one step.\n- **Test your integration.** Run a real task through the protocol and verify invocation.\n- **Document what changed.** The founder should understand the addition without reading your entire README.\n\n## Author\n\n**Abry Dela Vega**. Founder-engineer building with AI that enforces thinking.\n\n[LinkedIn](https://linkedin.com/in/abrydv) | [X](https://x.com/abrydeve) | [Facebook](https://facebook.com/logi9)\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n\n## Credits\n\nOrganism ships with three core systems by builders we respect: [GSD](https://github.com/coleam00/get-shit-done-cc) by Cole Medin, [Superpowers](https://github.com/anthropics/claude-plugins-official) by Anthropic, and [gstack](https://github.com/garrytan/gstack) by Garry Tan. The organism is the nervous system that routes their skills through a coordination protocol. New systems are welcome.\n\nThe 100 pitfalls are sourced from: Y Combinator, a16z, First Round Review, Annie Duke (\"Quit\"), Daniel Kahneman (\"Thinking, Fast and Slow\"), Nassim Taleb (\"The Black Swan\"), April Dunford (\"Obviously Awesome\"), Donald Miller (\"StoryBrand\"), Chip & Dan Heath (\"Made to Stick\"), Brian Balfour (Reforge), Peter Thiel (\"Zero to One\"), Paul Graham, Andrew Chen, David Sacks, the Startup Genome Report, and 40+ other researchers, investors, and founders who documented what goes wrong so others don't have to learn it the hard way.\n"}