(https://github.githubassets.com) (https://avatars.githubusercontent.com) (https://github-cloud.s3.amazonaws.com) (https://user-images.githubusercontent.com/) (https://github.githubassets.com) (https://avatars.githubusercontent.com)   (https://github.githubassets.com/assets/react-fa5e2e82e6e0ecc0.js)  (https://github.githubassets.com/assets/react-compiler-runtime-4610bd6d3de9c049.js)  (https://github.githubassets.com/assets/scheduler-58b860b049ca307c.js)  (https://github.githubassets.com/assets/react-dom-c7f52540bb6b77ed.js)  (https://github.githubassets.com/assets/react-dom-client-35b308126995de85.js)  (https://github.githubassets.com/assets/react-is-e0b593954b4706d8.js)  (https://github.githubassets.com/assets/react-jsx-runtime-4915cb0f5b3aff04.js)  (https://github.githubassets.com/assets/react-reconciler-8e99e505c4429605.js)  (../../github.githubassets.com/assets/light-3a3d2c708970e4e8.css)  (../../github.githubassets.com/assets/light_high_contrast-9c7b506bdc5ea73f.css)  (../../github.githubassets.com/assets/dark-c9dacb4ec19616db.css)  (../../github.githubassets.com/assets/dark_high_contrast-5ef38214a3eabc7d.css)                (../../github.githubassets.com/assets/primer-primitives-02e066689466a8cd.css)  (../../github.githubassets.com/assets/primer-38ae573fa780d76a.css)  (../../github.githubassets.com/assets/global-b577b4b65d1381c3.css)  (../../github.githubassets.com/assets/github-11ab453cdcc1b7c1.css)  (../../github.githubassets.com/assets/repository-542ca59b4b92999d.css)  (../../github.githubassets.com/assets/code-b25a4886e30e3e5f.css)  (https://github.githubassets.com/assets/wp-runtime-49480f8e762b0693.js)  (https://github.githubassets.com/assets/app-foundation-799625033ee8341e.js)  (https://github.githubassets.com/assets/app-runtime-1a555c9bb4a1f269.js)  (https://github.githubassets.com/assets/fetch-utilities-27ed50f7568a5f72.js)  (https://github.githubassets.com/assets/ser-2defe2918d9c9884.js)  (../../github.githubassets.com/assets/app-runtime.2f1b270bab5d7415.module.css)  (https://github.githubassets.com/assets/catalyst-5bc36fa5a846f5a0.js)  (https://github.githubassets.com/assets/selector-observer-7ae05416e4a383ae.js)  (https://github.githubassets.com/assets/relative-time-element-a7b7e0f1360ca8f9.js)  (https://github.githubassets.com/assets/by4-04f0d28829dc4df0.js)  (https://github.githubassets.com/assets/ja9-b94de714266ba389.js)  (https://github.githubassets.com/assets/3h2-5f8899065b81d778.js)  (https://github.githubassets.com/assets/t2-19741658de225445.js)  (https://github.githubassets.com/assets/z8j-d8f6fa7339115370.js)  (https://github.githubassets.com/assets/hjg-55b6d77c48226433.js)  (https://github.githubassets.com/assets/wc-9718c61e184d7417.js)  (https://github.githubassets.com/assets/runtime-helpers-26f2970b9e869a17.js)  (https://github.githubassets.com/assets/aria-live-edd851c704c6b3ca.js)  (https://github.githubassets.com/assets/hotkey-a82e6cb07443fd1c.js)  (https://github.githubassets.com/assets/react-core-c7332e94c0bffcae.js)  (https://github.githubassets.com/assets/cc-99eedace671eb2b6.js)  (https://github.githubassets.com/assets/urv-453c749eec9d7d37.js)  (https://github.githubassets.com/assets/4t-f1181f796eb9ea15.js)  (https://github.githubassets.com/assets/pb0-3a1794e99794195c.js)  (https://github.githubassets.com/assets/6n-e6e586acca87c769.js)  (https://github.githubassets.com/assets/zj-8d62ed720b193a80.js)  (https://github.githubassets.com/assets/9k-9938b9e1b5d2f0d0.js)  (https://github.githubassets.com/assets/0r-4a2b771052825f69.js)  (https://github.githubassets.com/assets/ow-98d10140e8228c74.js)  (https://github.githubassets.com/assets/mv1-7b21be52cdd60fa5.js)  (https://github.githubassets.com/assets/eou-b91079b9ea7074de.js)  (https://github.githubassets.com/assets/eon-36af335a1906af16.js)  (https://github.githubassets.com/assets/yga-dd50cf95593467fe.js)  (../../github.githubassets.com/assets/react-core.25ec5f5e1205d08d.module.css)  (https://github.githubassets.com/assets/n9-369bc13c0e8c5584.js)  (https://github.githubassets.com/assets/liv-7ba64ac238bca0a9.js)  (https://github.githubassets.com/assets/primer-react-911369ee234690ef.js)  (https://github.githubassets.com/assets/nc-28ebfc8e58bca42f.js)  (https://github.githubassets.com/assets/qmp-308230626a2aedb0.js)  (https://github.githubassets.com/assets/to-b501df3e06c1799a.js)  (https://github.githubassets.com/assets/t7l-423469c05c948a8b.js)  (https://github.githubassets.com/assets/4u-bf6e08201764cb0a.js)  (https://github.githubassets.com/assets/s07-527b0afa5c76403e.js)  (https://github.githubassets.com/assets/fe-f8365f29462c346a.js)  (https://github.githubassets.com/assets/zd-61606dd1c14634aa.js)  (https://github.githubassets.com/assets/7v5-d77d961bce5db1f3.js)  (https://github.githubassets.com/assets/15-627ae2a5640b1bab.js)  (https://github.githubassets.com/assets/5w-452c3a937483ff49.js)  (https://github.githubassets.com/assets/la-27ea91f01fa7ffcf.js)  (https://github.githubassets.com/assets/y0-02339f2a1b7b69ad.js)  (https://github.githubassets.com/assets/t9-28dc4f6af25a5400.js)  (https://github.githubassets.com/assets/208-3f7bc00201e868da.js)  (https://github.githubassets.com/assets/a68-c67bfbb035a5cd79.js)  (https://github.githubassets.com/assets/g0-73129ffe165d9c38.js)  (https://github.githubassets.com/assets/gw-4bf343b417f9ec19.js)  (https://github.githubassets.com/assets/g4-05e4d33e43f27775.js)  (https://github.githubassets.com/assets/0-4c5cb17b43424a9c.js)  (https://github.githubassets.com/assets/jn-9c45b198d99a47c8.js)  (https://github.githubassets.com/assets/q6j-256bc816dd682a0f.js)  (https://github.githubassets.com/assets/fn-2835e20691a288e2.js)  (https://github.githubassets.com/assets/i2-5e26ac37ee961d06.js)  (https://github.githubassets.com/assets/b2-35e229a50d0f3d05.js)  (https://github.githubassets.com/assets/pg-10c94bf4f9e9df2f.js)  (https://github.githubassets.com/assets/lrk-ea49e115e48ba34b.js)  (https://github.githubassets.com/assets/mlz-fce49bd96df2c99f.js)  (https://github.githubassets.com/assets/dx-17fc1b71910ed6ad.js)  (https://github.githubassets.com/assets/sm-22346830d5e5a763.js)  (https://github.githubassets.com/assets/ur-4cd875e44a87e9f6.js)  (https://github.githubassets.com/assets/pr-7e5e6964ac1c13a7.js)  (https://github.githubassets.com/assets/up-2550cb0824072126.js)  (https://github.githubassets.com/assets/gd-c0d7e6321e1379df.js)  (https://github.githubassets.com/assets/51-b582a312086b7975.js)  (https://github.githubassets.com/assets/c28-f2c3e9d4cd1ed8f5.js)  (https://github.githubassets.com/assets/ti-dc598d1734870bb6.js)  (https://github.githubassets.com/assets/stw-61e8fd83c623657f.js)  (https://github.githubassets.com/assets/w77-28ce9e19af8169bd.js)  (https://github.githubassets.com/assets/7km-3da4ef0ccc6aceb4.js)  (../../github.githubassets.com/assets/primer-react-css.5c285cfb9886ddbc.module.css)  (../../github.githubassets.com/assets/w77.637a64bd4bd2d439.module.css)  (../../github.githubassets.com/assets/code-view.7bf07b901f0dd46c.module.css)  GitHub - Algoza-Solutions/spider-protocol: Governed, regression-gated multi-agent software delivery protocol for Codex, Claude Code, OpenCode & Gemini CLI · GitHub      (repo_source) (https://github.githubassets.com/)   (https://github.com/opensearch.xml) (GitHub) (https://github.com/fluidicon.png) (GitHub)                      (https://github.githubassets.com/assets/pinned-octocat-093da3e6fa40.svg) (https://github.githubassets.com/favicons/favicon.png) (../../github.githubassets.com/favicons/favicon.svg)  (../manifest.json)   (spider-protocol.html#start-of-content) Skip to content   (https://github.githubassets.com/assets/9m-6b203be6a68b3fa3.js)  (https://github.githubassets.com/assets/keyboard-shortcuts-dialog-1f8c4170d1cab7c4.js)  (../../github.githubassets.com/assets/primer-react-css.5c285cfb9886ddbc.module.css)  (../../github.githubassets.com/assets/keyboard-shortcuts-dialog.169b8eec8672ced8.module.css)    (https://github.githubassets.com/assets/g6m-c6c2e85d4cbe6e0f.js)  (https://github.githubassets.com/assets/app-install-banner-partial-2d3bbe9e6cefa647.js)  (../../github.githubassets.com/assets/primer-react-css.5c285cfb9886ddbc.module.css)  (../../github.githubassets.com/assets/app-install-banner-partial.4c7f55002e890351.module.css)    (https://github.githubassets.com/assets/h3j-9cb42e7fadf1869c.js)  (https://github.githubassets.com/assets/qz-3de0b6ee8ce979cd.js)  (https://github.githubassets.com/assets/fz-cb55e83c29d0a351.js)  (https://github.githubassets.com/assets/skl-90fea02d318d647f.js)  (https://github.githubassets.com/assets/h4-5f55e06e297293d6.js)  (https://github.githubassets.com/assets/z7-54a4e2eade1aa26b.js)  (https://github.githubassets.com/assets/a6j-b220084b9f4f7387.js)  (https://github.githubassets.com/assets/marketing-header-c315b2ae7d838c71.js)  (../../github.githubassets.com/assets/primer-react-css.5c285cfb9886ddbc.module.css)  (../../github.githubassets.com/assets/primer-react-brand-css.bf4feb030857a64b.module.css)  (../../github.githubassets.com/assets/a6j.7ba30aa85251a62f.module.css)  Navigation Menu       (https://github.com/)    (https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FAlgoza-Solutions%2Fspider-protocol) Sign in       Appearance settings   Platform   AI CODE CREATION (https://github.com/features/copilot)    GitHub Copilot Write better code with AI    (https://github.com/features/ai/github-app)   GitHub Copilot app Direct agents from issue to merge    (https://github.com/mcp)    MCP Registry Integrate external tools       DEVELOPER WORKFLOWS (https://github.com/features/actions)   Actions Automate any workflow    (https://github.com/features/codespaces)    Codespaces Instant dev environments    (https://github.com/features/issues)    Issues Plan and track work    (https://github.com/features/code-review)   Code Review Manage code changes    (https://github.com/features/code-quality)    Code Quality Enforce quality at merge       APPLICATION SECURITY (https://github.com/security/advanced-security)   GitHub Advanced Security Find and fix vulnerabilities    (https://github.com/security/advanced-security/code-security)   Code security Secure your code as you build    (https://github.com/security/advanced-security/secret-protection)   Secret protection Stop leaks before they start       EXPLORE (https://github.com/why-github) Why GitHub   (https://docs.github.com) Documentation     (https://github.blog) Blog     (https://github.blog/changelog) Changelog     (https://github.com/marketplace) Marketplace       (https://github.com/features) View all features          Solutions   BY COMPANY SIZE (https://github.com/enterprise) Enterprises   (https://github.com/team) Small and medium teams   (https://github.com/enterprise/startups) Startups   (https://github.com/solutions/industry/nonprofits) Nonprofits      BY USE CASE (https://github.com/solutions/use-case/app-modernization) App Modernization   (https://github.com/solutions/use-case/devsecops) DevSecOps   (https://github.com/solutions/use-case/devops) DevOps   (https://github.com/solutions/use-case/ci-cd) CI/CD   (https://github.com/solutions/use-case) View all use cases         BY INDUSTRY (https://github.com/solutions/industry/healthcare) Healthcare   (https://github.com/solutions/industry/financial-services) Financial services   (https://github.com/solutions/industry/manufacturing) Manufacturing   (https://github.com/solutions/industry/government) Government   (https://github.com/solutions/industry) See all industries          (https://github.com/solutions) View all solutions          Resources   EXPLORE BY TOPIC (https://github.com/resources/articles?topic=ai) AI   (https://github.com/resources/articles?topic=software-development) Software Development   (https://github.com/resources/articles?topic=devops) DevOps   (https://github.com/resources/articles?topic=security) Security   (https://github.com/resources/articles) View all topics         EXPLORE BY TYPE (https://github.com/customer-stories) Customer stories   (https://github.com/resources/events) Events & webinars   (https://github.com/resources/whitepapers) Ebooks & reports   (https://github.com/solutions/executive-insights) Business insights   (https://skills.github.com) GitHub Skills        SUPPORT & SERVICES (https://docs.github.com) Documentation     (https://support.github.com) Customer support     (https://github.com/orgs/community/discussions) Community forum   (https://github.com/trust-center) Trust center   (https://github.com/partners) Partners       (https://github.com/resources) View all resources          Open Source   COMMUNITY (https://github.com/open-source/sponsors)   GitHub Sponsors Fund open source developers       PROGRAMS (https://securitylab.github.com) Security Lab     (https://maintainers.github.com) Maintainer Community     (https://stars.github.com) GitHub Stars     (https://archiveprogram.github.com) Archive Program        REPOSITORIES (https://github.com/topics) Topics   (https://github.com/trending) Trending   (https://github.com/collections) Collections           Enterprise   ENTERPRISE SOLUTIONS (https://github.com/enterprise)   Enterprise platform AI-powered developer platform       AVAILABLE ADD-ONS (https://github.com/security/advanced-security)   GitHub Advanced Security Enterprise-grade security features    (https://github.com/features/copilot/copilot-business)    Copilot for Business Enterprise-grade AI features    (https://github.com/enterprise/premium-support)   Premium Support Enterprise-grade 24/7 support            (https://github.com/pricing) Pricing      Search /       (https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FAlgoza-Solutions%2Fspider-protocol) Sign in    (https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E&source=header-repo&source_repo=Algoza-Solutions%2Fspider-protocol) Sign up       Appearance settings             You signed in with another tab or window. (spider-protocol.html) Reload to refresh your session. You signed out in another tab or window. (spider-protocol.html) Reload to refresh your session. You switched accounts on another tab or window. (spider-protocol.html) Reload to refresh your session.    Dismiss alert     (https://github.githubassets.com/assets/cn-7a4f85e8a901f4f7.js)  (https://github.githubassets.com/assets/0b-a7be65069037ffea.js)  (https://github.githubassets.com/assets/t5-2c5d26edae56bda2.js)  (https://github.githubassets.com/assets/5l-60d6b21dcbe3c5b7.js)  (https://github.githubassets.com/assets/1a-76a60fd58c2fa34b.js)  (https://github.githubassets.com/assets/rk7-418a4f74edbc9f0d.js)  (https://github.githubassets.com/assets/zxp-2ea1ea5a152b7ddb.js)  (https://github.githubassets.com/assets/9ty-c9c39216c8b27b58.js)  (https://github.githubassets.com/assets/r3j-2177885dae8b60eb.js)  (https://github.githubassets.com/assets/1t-bdeb715d0c007303.js)  (https://github.githubassets.com/assets/3j-116222f7d295a51a.js)  (https://github.githubassets.com/assets/aj-7444763a0a51ca63.js)  (https://github.githubassets.com/assets/sgn-defb2f30428a579f.js)  (https://github.githubassets.com/assets/li6-9946ed6b82f92046.js)  (https://github.githubassets.com/assets/jv-3d49136cffaf68c9.js)  (https://github.githubassets.com/assets/jao-e3369509b9c61929.js)  (https://github.githubassets.com/assets/global-nav-bar-21f6cb2ccd89af48.js)  (../../github.githubassets.com/assets/primer-react-css.5c285cfb9886ddbc.module.css)  (../../github.githubassets.com/assets/global-nav-bar.7ce07bd34cf09f7c.module.css)  (https://github.com/Algoza-Solutions) Algoza-Solutions   (spider-protocol.html) spider-protocol        Repository navigation  (spider-protocol.html)    Code   (https://github.com/Algoza-Solutions/spider-protocol/issues)     Issues   (https://github.com/Algoza-Solutions/spider-protocol/pulls)    Pull requests   (https://github.com/Algoza-Solutions/spider-protocol/actions)    Actions   (https://github.com/Algoza-Solutions/spider-protocol/projects)    Projects   (https://github.com/Algoza-Solutions/spider-protocol/security)    Security and quality   (https://github.com/Algoza-Solutions/spider-protocol/pulse)    Insights     Moreitems              (../../avatars.githubusercontent.com/u/180573666@s=60&v=4)   (spider-protocol.html)   (Algoza-Solutions)  (spider-protocol) (spider-protocol.html) spider-protocol   Public    (https://github.com/login?return_to=%2FAlgoza-Solutions%2Fspider-protocol)    Notifications   You must be signed in to change notification settings  (https://github.com/login?return_to=%2FAlgoza-Solutions%2Fspider-protocol)    Fork0  (0 )     (https://github.com/login?return_to=%2FAlgoza-Solutions%2Fspider-protocol)    Star2  (2 )    You must be signed in to star a repository      About  Governed, regression-gated multi-agent software delivery protocol for Codex, Claude Code, OpenCode & Gemini CLI   (https://algozasolutions.com/) (https://algozasolutions.com/) algozasolutions.com/   Topics  (https://github.com/topics/agentic-workflow) agentic-workflow (https://github.com/topics/ai-agents) ai-agents (https://github.com/topics/claude-code) claude-code (https://github.com/topics/codex) codex (https://github.com/topics/gemini-cli) gemini-cli (https://github.com/topics/multi-agent-systems) multi-agent-systems (https://github.com/topics/opencode) opencode (https://github.com/topics/prompt-engineering) prompt-engineering (https://github.com/topics/software-engineering) software-engineering (https://github.com/topics/spec-driven-development) spec-driven-development (https://github.com/topics/spider-protocol) spider-protocol (https://github.com/topics/vibe-coding) vibe-coding  Resources  (spider-protocol.html#readme-ov-file)   Readme   (spider-protocol.html#MIT-1-ov-file)   MIT license   Contributing  (spider-protocol.html#contributing-ov-file)   Contributing   (https://github.com/Algoza-Solutions/spider-protocol/activity)   Activity   (https://github.com/Algoza-Solutions/spider-protocol/custom-properties)   Custom properties    Stars    2 stars  Watchers    0 watching  Forks  (https://github.com/Algoza-Solutions/spider-protocol/forks)   0  forks     (https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2FAlgoza-Solutions%2Fspider-protocol&report=Algoza-Solutions+%28user%29) Report repository            main           (https://github.com/Algoza-Solutions/spider-protocol/branches)    Branches   (https://github.com/Algoza-Solutions/spider-protocol/tags)    Tags    (https://github.com/Algoza-Solutions/spider-protocol/branches)    (https://github.com/Algoza-Solutions/spider-protocol/tags)          (Go to file) ()      Go to file        Code         Open more actions menu     Latest commit   History (https://github.com/Algoza-Solutions/spider-protocol/commits/main/)    1 Commit     (https://github.com/Algoza-Solutions/spider-protocol/commits/main/)      1 Commit      Folders and files Name  Name  (Last commit message) Last commit message   (Last commit date) Last commit date       (This path skips through empty directories) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/.github/workflows) .github/ workflows         (This path skips through empty directories) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/.github/workflows) .github/ workflows               (agents) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/agents) agents        (agents) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/agents) agents              (docs) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/docs) docs        (docs) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/docs) docs              (scripts) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/scripts) scripts        (scripts) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/scripts) scripts              (skills) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/skills) skills        (skills) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/skills) skills              (template) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/template) template        (template) (https://github.com/Algoza-Solutions/spider-protocol/tree/main/template) template              (.editorconfig) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/.editorconfig) .editorconfig        (.editorconfig) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/.editorconfig) .editorconfig              (.gitignore) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/.gitignore) .gitignore        (.gitignore) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/.gitignore) .gitignore              (CONTRIBUTING.md) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/CONTRIBUTING.md) CONTRIBUTING.md        (CONTRIBUTING.md) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/CONTRIBUTING.md) CONTRIBUTING.md              (LICENSE) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/LICENSE) LICENSE        (LICENSE) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/LICENSE) LICENSE              (README.md) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/README.md) README.md        (README.md) (https://github.com/Algoza-Solutions/spider-protocol/blob/main/README.md) README.md            View all files        Repository files navigation  (spider-protocol.html#)    README   (spider-protocol.html#)    Contributing   (spider-protocol.html#)    MIT license     Moreitems               (SPIDER Protocol — Governed, Regression-Gated Multi-Agent Software Delivery)   (https://github.com/Algoza-Solutions/spider-protocol/releases) (Release)  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/LICENSE) (License: MIT)  (https://github.com/Algoza-Solutions/spider-protocol/actions/workflows/verify.yml) (Verify SPIDER Bundle)  (spider-protocol.html#quickstart) (Agents: Codex | Claude Code | OpenCode | Gemini)  (https://algozasolutions.com/) (Built by Algoza Solutions)   Stop AI coding agents from over-engineering, losing architectural context, or breaking working features in endless fix loops.  (spider-protocol.html#why-spider) Why SPIDER? • (spider-protocol.html#how-it-works) How It Works • (spider-protocol.html#quickstart) Quickstart • (spider-protocol.html#the-8-agent-roles) The 8 Agent Roles • (https://github.com/Algoza-Solutions/spider-protocol/blob/main/docs/architecture.md) Architecture & Docs   Why SPIDER? (spider-protocol.html#why-spider)     Single-prompt coding agents and vibe-coding tools excel at version one—and routinely collapse on iteration fifteen: Silent Over-Engineering: Ask for a small feature and the agent invents three new wrapper classes, a service layer, and an unrequested dependency. Context Amnesia: Architectural decisions live in transient chat history. Two sessions later, a new agent session violates invariants from last week. Self-Grading Homework: The same agent that wrote the code declares "All done!" after skipping edge cases or weakening tests. Destructive Fix Loops: When a bug appears, the agent patches symptoms blindly, introducing regressions in previously working modules.  SPIDER turns your repository into a governed engineering organization. Work is split across 8 specialized role contracts , coordinated through shared, append-only Markdown/YAML state files , and gated by an independent validator that audits git diffs, upstream architecture contracts, and full-suite regression tests before any task can be marked Done . The SPIDER Model: 6 Phases, 8 Legs, 1 Web (spider-protocol.html#the-spider-model-6-phases-8-legs-1-web)     SPIDER combines 6 engineering phases (S.P.I.D.E.R. ) , 8 specialist roles ("8 legs") so no single agent grades its own homework, and 1 web-structured repository memory ((https://github.com/Algoza-Solutions/spider-protocol/blob/main/docs/terminology.md) docs/terminology.md  ): Letter Phase Role Owner(s) Repository Artifact(s)   S  Specify  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/spider-orchestrator/SKILL.md) spider-orchestrator  , (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/architect/SKILL.md) architect  , (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/ui-designer/SKILL.md) ui-designer   Preflight minimum-change baseline, requirements.md (REQ-N ), blast-radius-summary.md , build-plan.md , design.html   P  Plan  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/planner/SKILL.md) planner   Peer KISS challenge, task-index.yaml , and features/<slug>/tasks/tN-*.md with typed resumable STEPS   I  Implement  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/task-executor/SKILL.md) task-executor   Code changes strictly inside authorized STEPS (Pending → Active → Ready for validation )  D  Document  All writers + (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/doc-cleanup/SKILL.md) doc-cleanup   Newest-first append-only decisions.md , living architecture.md , task ## LOG / ## DEBUG LOG , and tombstoned compaction  E  Evaluate  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/task-validator/SKILL.md) task-validator  , (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/debugger/SKILL.md) debugger   validation/tN-validation.json (contract chain + diff + regression suite gate) and defects/bug-req-N-*.md   R  Review  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/spider-orchestrator/SKILL.md) spider-orchestrator  + Human  Closed repair-loop routing, Decision Checkpoints , and Iteration Checkpoints before REQ closure     The Hub (project.md & requirements.md ): Center of the web where agents Sense current project state before acting. Radials (features/<slug>/tasks/tN-*.md ): Task spokes branching from the Hub, with Spirals (## LOG ) tracking each iteration. The Dragline (decisions.md + Git history): The safety silk thread trailed behind every change so the team can Retreat or Repair cleanly without destructive fix loops.  What Makes SPIDER Different? (spider-protocol.html#what-makes-spider-different)     First-generation Spec-Driven Development (SDD) tools proved that written specs beat unstructured "vibe coding," but introduced new failure modes in real-world brownfield repositories: heavy ceremony on small fixes , blindly trusting AI-generated architectural bloat , and letting execution loops grade their own homework . SPIDER is a Generation-2 SDD protocol built to solve those exact trade-offs: Capability Gen-1 Spec / Prompt Packs 🕷️ SPIDER Protocol (Gen-2 SDD)   Scope & Bloat Control  Agents freely invent helpers, layers, and abstractions Minimum-Change Baseline: Preflight establishes the smallest direct change; any new file, class, or dependency requires explicit user approval  Architecture vs. KISS  Planner blindly implements whatever Architect writes Peer KISS Challenge: Planner is a peer Tech Lead that halts planning and challenges over-engineered Architect boundaries  Execution Discipline  Free-form task checklists Typed Resumable STEPS : Exact [create] , [modify] , [delete] , [reference] (read-only), and [run] contracts; only one task can be Active at a time  Quality Gate  Executor marks its own task complete Independent task-validator : Executor can only mark Ready for validation . Validator audits the full contract chain, git diff, and regression suite before marking Done   Bug Handling  Ad-hoc patching mid-task Dedicated debugger Role: Hypothesis-driven root-cause isolation with durable defect records (features/<slug>/defects/ )  Contract Integrity  Unverified markdown prompts SHA-256 Manifest Verification: verify_specialist_skills.py cryptographically verifies all specialist contracts before role handoffs     Where SPIDER Fits in the Ecosystem (spider-protocol.html#where-spider-fits-in-the-ecosystem)     Tool Sweet Spot Trade-off How SPIDER Differs   BMAD-METHOD  Agile persona simulation (PM, Architect, SM, Dev, QA/TEA) + Quick Flow SM/Dev agents rarely challenge Architect bloat; full-track PRD/story ceremony is heavy Preflight Minimum-Change Baseline + Planner ↔ Architect Peer KISS Challenge block unapproved abstractions; SHA-256 verified skill bundle  GitHub Spec Kit  Slash-command pipeline (/speckit.specify → plan → tasks → analyze ) Single-agent command sequence; /speckit.analyze checks pre-code markdown consistency 8 separated role contracts , dedicated debugger role (defects/ ), and a post-code task-validator  auditing git diffs against typed STEPS + live test suites  Superpowers (obra )  Composable TDD, debugging, and subagent code-review skills Spawns fresh subagents per task; tracks state per plan rather than a permanent repo-wide ledger In-thread role transitions (preserving prompt cache prefixes) + permanent cross-feature REQ → Decision → Task → Validation ledger + Peer KISS Challenge  OpenSpec / GSD  Brownfield delta specs (/opsx:verify ) & fast execution loops Lighter on role-separated governance and upstream anti-bloat challenges Combines a low-ceremony Fast Path with two-tier anti-bloat governance (Minimum-Change Baseline + KISS Challenge) and hard task-validator Done gating      How It Works (spider-protocol.html#how-it-works)     flowchart TB
    User(["👤 User Request"]) --> Preflight["🎯 Orchestrator Preflight<br/>Clarify intent & confirm Minimum-Change Baseline"]
    Preflight --> Req["📋 Record Ready REQ-N in requirements.md<br/>Coarse Triage"]
    Req -- "Localized tested change<br/>inside 1 existing component" --> FastPlan["📐 Planner (Fast Path)"]
    Req -- "All other changes" --> Arch["🏛️ Architect<br/>Impact Sweep + Plan Freshness + UI Need"]
    Arch -- "ui_design_needed: true" --> UI["🎨 UI Designer<br/>features/<slug>/design.html"]
    UI --> ArchReady["🏛️ Architect<br/>Design Readiness Reconciliation"]
    Arch -- "ui_design_needed: false" --> Plan["📐 Planner<br/>KISS Design + Fewest Cohesive Tasks + Typed STEPS"]
    ArchReady --> Plan
    FastPlan --> Exec["⚙️ Task Executor<br/>Exact task_id: Pending → Active → Ready for validation"]
    Plan -- "KISS peer challenge<br/>(if boundary over-engineered)" --> Arch
    Plan --> Exec
    Exec --> Val{"🛡️ Task Validator<br/>REQ + STEPS + Diff + Regression Gate"}
    Val -- "PASS" --> Done(["✅ Task Done → User Checkpoint"])
    Val -- "FAIL: mechanical step" --> Exec
    Val -- "FAIL: defect / regression" --> Debug["🔍 Debugger<br/>Root-Cause Isolation & Authorized Fix"]
    Val -- "FAIL: task/plan gap" --> Plan
    Val -- "FAIL: boundary gap" --> Arch
    Debug --> Exec       Loading    Quickstart (spider-protocol.html#quickstart)     SPIDER requires Python 3.10+ (standard library only, zero external packages) for its installer and SHA-256 bundle verifier. 1. Clone the repository (spider-protocol.html#1-clone-the-repository)     git clone https://github.com/Algoza-Solutions/spider-protocol.git cd spider-protocol  2. Install skills / agents into your coding environment (spider-protocol.html#2-install-skills--agents-into-your-coding-environment)     Install into Codex (~/.codex/skills ), Claude Code (~/.claude/agents ), OpenCode (~/.config/opencode/skills ), Gemini / Antigravity (~/.gemini/config/skills ), or all at once: # Install into all supported environments (Codex, OpenCode, Gemini/Antigravity, Claude Code) python scripts/install.py --target all # Or install into a specific environment: python scripts/install.py --target codex
python scripts/install.py --target claude
python scripts/install.py --target opencode
python scripts/install.py --target gemini  3. Initialize SPIDER in your project repository (spider-protocol.html#3-initialize-spider-in-your-project-repository)     Bootstrap the lightweight Markdown/YAML state stores (project.md , requirements.md , decisions.md , task-index.yaml , architecture/ , features/ ) in any existing or new repository: python scripts/install.py --init-project /path/to/your/project  4. Start building with the Orchestrator (spider-protocol.html#4-start-building-with-the-orchestrator)     Open your project in your coding agent and invoke spider-orchestrator  (or @orchestrator in Claude Code) with your feature request or bug report: "Use spider-orchestrator: Add rate limiting to the /api/login endpoint using our existing Redis client."   The orchestrator will: Inspect your codebase read-only and propose the minimum direct baseline (disclosing if any new file or structure is needed). Wait for your confirmation before recording REQ-1 in requirements.md . Route through the fast path (or Architect → Planner for cross-cutting changes), execute the exact task, and run task-validator to verify the diff and test suite.  The 8 Agent Roles (spider-protocol.html#the-8-agent-roles)     Role (skills/ & agents/ ) Responsibility   (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/spider-orchestrator/SKILL.md) spider-orchestrator   (orchestrator.md ) Owns conversational preflight discovery, minimum-baseline confirmation, REQ-N lifecycle, coarse triage, exact task pointer routing, repair loops, and user checkpoints.  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/architect/SKILL.md) architect   (architect.md ) Evaluates architectural impact, plan freshness, and UI-design need independently; owns durable boundary decisions (decisions.md ), build-plan.md , and blast-radius-summary.md .  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/ui-designer/SKILL.md) ui-designer   (ui-designer.md ) Produces self-contained, accessible UX/UI specifications (features/<slug>/design.html ) covering user flows, screen states, and interaction contracts before task planning.  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/planner/SKILL.md) planner   (planner.md ) Peer Tech Lead under KISS: challenges unnecessary upstream complexity, creates the fewest cohesive tasks, and writes typed resumable STEPS in features/<slug>/tasks/tN-*.md .  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/task-executor/SKILL.md) task-executor   (task-executor.md ) Implements one exact dispatched task inside its authorized shape (Pending → Active → Ready for validation ). Never marks its own work Done .  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/task-validator/SKILL.md) task-validator   (task-validator.md ) Audits the full upstream contract chain, git diff, and project regression test suite; writes features/<slug>/validation/tN-validation.json ; alone marks delivery tasks Done .  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/debugger/SKILL.md) debugger   (debugger.md ) Investigates post-validation failures or user-reported bugs via hypothesis testing; writes durable defect reports (features/<slug>/defects/ ) and applies only localized authorized fixes.  (https://github.com/Algoza-Solutions/spider-protocol/blob/main/skills/doc-cleanup/SKILL.md) doc-cleanup   (doc-cleanup.md ) Compacts completed task files and stale artifacts while preserving REQ acceptance evidence, monotonic task-index.yaml tombstones, and immutable decisions.     Repository State Stores (In Your Project) (spider-protocol.html#repository-state-stores-in-your-project)     SPIDER keeps all project memory in human-readable files committed alongside your code—never trapped in proprietary cloud state or ephemeral chat logs: your-project/
├── project.md                              # Hub: project overview, current state, and active/completed task table
├── requirements.md                         # Orchestrator-owned REQ/AC registry and validation evidence trail
├── decisions.md                            # Append-only architectural decision log (D1, D2, ...)
├── task-index.yaml                         # Machine-readable task state, REQ trace, and monotonic high-water mark
├── architecture/
│   ├── architecture.md                     # Living system architecture reference
│   └── flows.md                            # Key runtime and protocol flows
└── features/
    └── <feature-slug>/
        ├── requirements.md                 # Detailed requirement contract + confirmed minimum baseline
        ├── blast-radius-summary.md         # Architect impact sweep & triage metadata
        ├── build-plan.md                   # Component boundary & integration plan (when architecture changes)
        ├── design.html                     # UI/UX specification (when ui_design_needed is true)
        ├── tasks/
        │   └── t1-<slug>.md                # Planner-authored task contract with GOAL, typed STEPS, NOW, and LOG
        ├── validation/
        │   └── t1-validation.json          # Structured validator audit report
        └── defects/
            └── bug-req-N-<slug>.md         # Debugger root-cause diagnosis report    Verifying Bundle Integrity (spider-protocol.html#verifying-bundle-integrity)     spider-orchestrator includes a zero-dependency cryptographic verifier that checks manifest version, role directory structure, frontmatter, and line-ending-normalized SHA-256 digests across all 7 specialist skills: # Verify the repository skill bundle python skills/spider-orchestrator/scripts/verify_specialist_skills.py --codex-home . # Run the 22-test behavioral regression suite python -m unittest discover -s skills/spider-orchestrator/scripts -v  Documentation (spider-protocol.html#documentation)     (https://github.com/Algoza-Solutions/spider-protocol/blob/main/docs/architecture.md) Protocol Architecture (docs/architecture.md )  — System layers, role boundaries, and core invariants. (https://github.com/Algoza-Solutions/spider-protocol/blob/main/docs/flows.md) Routing & Repair Flows (docs/flows.md )  — Fast path vs. deep triage, closed repair loops, taskless defect intake, and Done revalidation audits. (https://github.com/Algoza-Solutions/spider-protocol/blob/main/docs/terminology.md) Evolving Spider Terminology (docs/terminology.md )  — Mental model mapping protocol concepts (Hub , Radials , Dragline , Sense → Spin → Wrap → Anchor ). (https://github.com/Algoza-Solutions/spider-protocol/blob/main/CONTRIBUTING.md) Contributing Guide (CONTRIBUTING.md )  — How to update role contracts and regenerate manifest hashes.  Built in Production by Algoza Solutions (spider-protocol.html#built-in-production-by-algoza-solutions)     SPIDER was created and battle-tested by (https://algozasolutions.com/) Algoza Solutions  to run disciplined, regression-checked AI software engineering across production codebases. Have an AI-built or vibe-coded app (Lovable, Bolt, Replit, Cursor, v0) that keeps breaking as you add features, or want managed SPIDER engineering for your project? Drop us an email at (mailto:info@algozasolutions.com) info@algozasolutions.com  — we harden fragile codebases, fix security gaps, and manage ongoing development with SPIDER's regression-gated workflow so new changes never break existing features.  License (spider-protocol.html#license)     Released under the (https://github.com/Algoza-Solutions/spider-protocol/blob/main/LICENSE) MIT License . Copyright © 2026 (https://algozasolutions.com/) Algoza Solutions (OPC) Private Limited .          About  Governed, regression-gated multi-agent software delivery protocol for Codex, Claude Code, OpenCode & Gemini CLI   (https://algozasolutions.com/) (https://algozasolutions.com/) algozasolutions.com/   Topics  (https://github.com/topics/agentic-workflow) agentic-workflow (https://github.com/topics/ai-agents) ai-agents (https://github.com/topics/claude-code) claude-code (https://github.com/topics/codex) codex (https://github.com/topics/gemini-cli) gemini-cli (https://github.com/topics/multi-agent-systems) multi-agent-systems (https://github.com/topics/opencode) opencode (https://github.com/topics/prompt-engineering) prompt-engineering (https://github.com/topics/software-engineering) software-engineering (https://github.com/topics/spec-driven-development) spec-driven-development (https://github.com/topics/spider-protocol) spider-protocol (https://github.com/topics/vibe-coding) vibe-coding  Resources  (spider-protocol.html#readme-ov-file)   Readme   (spider-protocol.html#MIT-1-ov-file)   MIT license   Contributing  (spider-protocol.html#contributing-ov-file)   Contributing   (https://github.com/Algoza-Solutions/spider-protocol/activity)   Activity   (https://github.com/Algoza-Solutions/spider-protocol/custom-properties)   Custom properties    Stars    2 stars  Watchers    0 watching  Forks  (https://github.com/Algoza-Solutions/spider-protocol/forks)   0  forks     (https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2FAlgoza-Solutions%2Fspider-protocol&report=Algoza-Solutions+%28user%29) Report repository    Releases     Packages    Contributors    Languages                            Footer (https://github.com)    © 2026 GitHub, Inc.   Footer navigation (https://docs.github.com/site-policy/github-terms/github-terms-of-service) Terms  (https://docs.github.com/site-policy/privacy-policies/github-privacy-statement) Privacy  (https://github.com/security) Security  (https://www.githubstatus.com/) Status  (https://github.community/) Community  (https://docs.github.com/) Docs  (https://support.github.com?tags=dotcom-footer) Contact  Manage cookies    Do not share my personal information              You can’t perform that action at this time.