{
    "archive_path": "archive/1793138714.675684",
    "base_url": "github.com/Algoza-Solutions/spider-protocol",
    "basename": "spider-protocol",
    "bookmarked_date": "2026-10-27 22:05",
    "canonical": {
        "archive_org_path": "https://web.archive.org/web/github.com/Algoza-Solutions/spider-protocol",
        "dom_path": "output.html",
        "favicon_path": "favicon.ico",
        "git_path": "git/",
        "google_favicon_path": "https://www.google.com/s2/favicons?domain=github.com",
        "headers_path": "headers.json",
        "htmltotext_path": "htmltotext.txt",
        "index_path": "index.html",
        "media_path": "media/",
        "mercury_path": "mercury/content.html",
        "pdf_path": "output.pdf",
        "readability_path": "readability/content.html",
        "screenshot_path": "screenshot.png",
        "singlefile_path": "singlefile.html",
        "warc_path": "warc/",
        "wget_path": "github.com/Algoza-Solutions/spider-protocol.html"
    },
    "domain": "github.com",
    "extension": "",
    "hash": "1P2W5YNG7GVYE5EPG50F",
    "history": {
        "archive_org": [],
        "dom": [],
        "favicon": [
            {
                "cmd": [
                    "curl",
                    "--silent",
                    "--location",
                    "--compressed",
                    "--max-time",
                    "120",
                    "--output",
                    "favicon.ico",
                    "--user-agent",
                    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) curl/curl 8.14.1 (x86_64-pc-linux-gnu)",
                    "https://www.google.com/s2/favicons?domain=github.com"
                ],
                "cmd_version": "curl 8.14.1 (x86_64-pc-linux-gnu)",
                "end_ts": "2026-10-27T22:06:20.101799+00:00",
                "index_texts": null,
                "output": "favicon.ico",
                "pwd": "/data/archive/1793138714.675684",
                "schema": "ArchiveResult",
                "start_ts": "2026-10-27T22:06:19.606603+00:00",
                "status": "succeeded"
            }
        ],
        "git": [],
        "headers": [
            {
                "cmd": [
                    "curl",
                    "--silent",
                    "--location",
                    "--compressed",
                    "--head",
                    "--max-time",
                    "120",
                    "--user-agent",
                    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) curl/curl 8.14.1 (x86_64-pc-linux-gnu)",
                    "https://github.com/Algoza-Solutions/spider-protocol"
                ],
                "cmd_version": "curl 8.14.1 (x86_64-pc-linux-gnu)",
                "end_ts": "2026-10-27T22:06:20.866412+00:00",
                "index_texts": null,
                "output": "headers.json",
                "pwd": "/data/archive/1793138714.675684",
                "schema": "ArchiveResult",
                "start_ts": "2026-10-27T22:06:20.112129+00:00",
                "status": "succeeded"
            }
        ],
        "htmltotext": [],
        "media": [],
        "mercury": [
            {
                "cmd": [
                    "/app/node_modules/@postlight/parser/cli.js",
                    "https://github.com/Algoza-Solutions/spider-protocol"
                ],
                "cmd_version": "1.0.0",
                "end_ts": "2026-10-27T22:06:37.450598+00:00",
                "index_texts": null,
                "output": "mercury",
                "pwd": "/data/archive/1793138714.675684",
                "schema": "ArchiveResult",
                "start_ts": "2026-10-27T22:06:32.549832+00:00",
                "status": "succeeded"
            }
        ],
        "pdf": [],
        "readability": [
            {
                "cmd": [
                    "/app/node_modules/readability-extractor/readability-extractor",
                    "/tmp/tmprm6mnila",
                    "https://github.com/Algoza-Solutions/spider-protocol"
                ],
                "cmd_version": "0.0.11",
                "end_ts": "2026-10-27T22:06:32.537715+00:00",
                "index_texts": [
                    "Why SPIDER?\nSingle-prompt coding agents and vibe-coding tools excel at version one\u2014and routinely collapse on iteration fifteen:\n\nSilent Over-Engineering: Ask for a small feature and the agent invents three new wrapper classes, a service layer, and an unrequested dependency.\nContext Amnesia: Architectural decisions live in transient chat history. Two sessions later, a new agent session violates invariants from last week.\nSelf-Grading Homework: The same agent that wrote the code declares \"All done!\" after skipping edge cases or weakening tests.\nDestructive Fix Loops: When a bug appears, the agent patches symptoms blindly, introducing regressions in previously working modules.\n\nSPIDER 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.\nThe SPIDER Model: 6 Phases, 8 Legs, 1 Web\nSPIDER 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 (docs/terminology.md):\n\n\n\nLetter\nPhase\nRole Owner(s)\nRepository Artifact(s)\n\n\n\n\nS\nSpecify\nspider-orchestrator, architect, ui-designer\nPreflight minimum-change baseline, requirements.md (REQ-N), blast-radius-summary.md, build-plan.md, design.html\n\n\nP\nPlan\nplanner\nPeer KISS challenge, task-index.yaml, and features/<slug>/tasks/tN-*.md with typed resumable STEPS\n\n\nI\nImplement\ntask-executor\nCode changes strictly inside authorized STEPS (Pending \u2192 Active \u2192 Ready for validation)\n\n\nD\nDocument\nAll writers + doc-cleanup\nNewest-first append-only decisions.md, living architecture.md, task ## LOG / ## DEBUG LOG, and tombstoned compaction\n\n\nE\nEvaluate\ntask-validator, debugger\nvalidation/tN-validation.json (contract chain + diff + regression suite gate) and defects/bug-req-N-*.md\n\n\nR\nReview\nspider-orchestrator + Human\nClosed repair-loop routing, Decision Checkpoints, and Iteration Checkpoints before REQ closure\n\n\n\n\nThe Hub (project.md & requirements.md): Center of the web where agents Sense current project state before acting.\nRadials (features/<slug>/tasks/tN-*.md): Task spokes branching from the Hub, with Spirals (## LOG) tracking each iteration.\nThe 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.\n\n\nWhat Makes SPIDER Different?\nFirst-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.\nSPIDER is a Generation-2 SDD protocol built to solve those exact trade-offs:\n\n\n\nCapability\nGen-1 Spec / Prompt Packs\n\ud83d\udd77\ufe0f SPIDER Protocol (Gen-2 SDD)\n\n\n\n\nScope & Bloat Control\nAgents freely invent helpers, layers, and abstractions\nMinimum-Change Baseline: Preflight establishes the smallest direct change; any new file, class, or dependency requires explicit user approval\n\n\nArchitecture vs. KISS\nPlanner blindly implements whatever Architect writes\nPeer KISS Challenge: Planner is a peer Tech Lead that halts planning and challenges over-engineered Architect boundaries\n\n\nExecution Discipline\nFree-form task checklists\nTyped Resumable STEPS: Exact [create], [modify], [delete], [reference] (read-only), and [run] contracts; only one task can be Active at a time\n\n\nQuality Gate\nExecutor marks its own task complete\nIndependent task-validator: Executor can only mark Ready for validation. Validator audits the full contract chain, git diff, and regression suite before marking Done\n\n\nBug Handling\nAd-hoc patching mid-task\nDedicated debugger Role: Hypothesis-driven root-cause isolation with durable defect records (features/<slug>/defects/)\n\n\nContract Integrity\nUnverified markdown prompts\nSHA-256 Manifest Verification: verify_specialist_skills.py cryptographically verifies all specialist contracts before role handoffs\n\n\n\nWhere SPIDER Fits in the Ecosystem\n\n\n\nTool\nSweet Spot\nTrade-off\nHow SPIDER Differs\n\n\n\n\nBMAD-METHOD\nAgile persona simulation (PM, Architect, SM, Dev, QA/TEA) + Quick Flow\nSM/Dev agents rarely challenge Architect bloat; full-track PRD/story ceremony is heavy\nPreflight Minimum-Change Baseline + Planner \u2194 Architect Peer KISS Challenge block unapproved abstractions; SHA-256 verified skill bundle\n\n\nGitHub Spec Kit\nSlash-command pipeline (/speckit.specify \u2192 plan \u2192 tasks \u2192 analyze)\nSingle-agent command sequence; /speckit.analyze checks pre-code markdown consistency\n8 separated role contracts, dedicated debugger role (defects/), and a post-code task-validator auditing git diffs against typed STEPS + live test suites\n\n\nSuperpowers (obra)\nComposable TDD, debugging, and subagent code-review skills\nSpawns fresh subagents per task; tracks state per plan rather than a permanent repo-wide ledger\nIn-thread role transitions (preserving prompt cache prefixes) + permanent cross-feature REQ \u2192 Decision \u2192 Task \u2192 Validation ledger + Peer KISS Challenge\n\n\nOpenSpec / GSD\nBrownfield delta specs (/opsx:verify) & fast execution loops\nLighter on role-separated governance and upstream anti-bloat challenges\nCombines a low-ceremony Fast Path with two-tier anti-bloat governance (Minimum-Change Baseline + KISS Challenge) and hard task-validator Done gating\n\n\n\n\nHow It Works\n\n  \n      flowchart TB\n    User([\"\ud83d\udc64 User Request\"]) --> Preflight[\"\ud83c\udfaf Orchestrator Preflight<br/>Clarify intent & confirm Minimum-Change Baseline\"]\n    Preflight --> Req[\"\ud83d\udccb Record Ready REQ-N in requirements.md<br/>Coarse Triage\"]\n    Req -- \"Localized tested change<br/>inside 1 existing component\" --> FastPlan[\"\ud83d\udcd0 Planner (Fast Path)\"]\n    Req -- \"All other changes\" --> Arch[\"\ud83c\udfdb\ufe0f Architect<br/>Impact Sweep + Plan Freshness + UI Need\"]\n    Arch -- \"ui_design_needed: true\" --> UI[\"\ud83c\udfa8 UI Designer<br/>features/<slug>/design.html\"]\n    UI --> ArchReady[\"\ud83c\udfdb\ufe0f Architect<br/>Design Readiness Reconciliation\"]\n    Arch -- \"ui_design_needed: false\" --> Plan[\"\ud83d\udcd0 Planner<br/>KISS Design + Fewest Cohesive Tasks + Typed STEPS\"]\n    ArchReady --> Plan\n    FastPlan --> Exec[\"\u2699\ufe0f Task Executor<br/>Exact task_id: Pending \u2192 Active \u2192 Ready for validation\"]\n    Plan -- \"KISS peer challenge<br/>(if boundary over-engineered)\" --> Arch\n    Plan --> Exec\n    Exec --> Val{\"\ud83d\udee1\ufe0f Task Validator<br/>REQ + STEPS + Diff + Regression Gate\"}\n    Val -- \"PASS\" --> Done([\"\u2705 Task Done \u2192 User Checkpoint\"])\n    Val -- \"FAIL: mechanical step\" --> Exec\n    Val -- \"FAIL: defect / regression\" --> Debug[\"\ud83d\udd0d Debugger<br/>Root-Cause Isolation & Authorized Fix\"]\n    Val -- \"FAIL: task/plan gap\" --> Plan\n    Val -- \"FAIL: boundary gap\" --> Arch\n    Debug --> Exec\n\n    \n  \n    \n      Loading\n\n  \n\n\n\nQuickstart\nSPIDER requires Python 3.10+ (standard library only, zero external packages) for its installer and SHA-256 bundle verifier.\n1. Clone the repository\ngit clone https://github.com/Algoza-Solutions/spider-protocol.git\ncd spider-protocol\n2. Install skills / agents into your coding environment\nInstall into Codex (~/.codex/skills), Claude Code (~/.claude/agents), OpenCode (~/.config/opencode/skills), Gemini / Antigravity (~/.gemini/config/skills), or all at once:\n# Install into all supported environments (Codex, OpenCode, Gemini/Antigravity, Claude Code)\npython scripts/install.py --target all\n\n# Or install into a specific environment:\npython scripts/install.py --target codex\npython scripts/install.py --target claude\npython scripts/install.py --target opencode\npython scripts/install.py --target gemini\n3. Initialize SPIDER in your project repository\nBootstrap the lightweight Markdown/YAML state stores (project.md, requirements.md, decisions.md, task-index.yaml, architecture/, features/) in any existing or new repository:\npython scripts/install.py --init-project /path/to/your/project\n4. Start building with the Orchestrator\nOpen your project in your coding agent and invoke spider-orchestrator (or @orchestrator in Claude Code) with your feature request or bug report:\n\n\"Use spider-orchestrator: Add rate limiting to the /api/login endpoint using our existing Redis client.\"\n\nThe orchestrator will:\n\nInspect your codebase read-only and propose the minimum direct baseline (disclosing if any new file or structure is needed).\nWait for your confirmation before recording REQ-1 in requirements.md.\nRoute through the fast path (or Architect \u2192 Planner for cross-cutting changes), execute the exact task, and run task-validator to verify the diff and test suite.\n\n\nThe 8 Agent Roles\n\n\n\nRole (skills/ & agents/)\nResponsibility\n\n\n\n\nspider-orchestrator (orchestrator.md)\nOwns conversational preflight discovery, minimum-baseline confirmation, REQ-N lifecycle, coarse triage, exact task pointer routing, repair loops, and user checkpoints.\n\n\narchitect (architect.md)\nEvaluates architectural impact, plan freshness, and UI-design need independently; owns durable boundary decisions (decisions.md), build-plan.md, and blast-radius-summary.md.\n\n\nui-designer (ui-designer.md)\nProduces self-contained, accessible UX/UI specifications (features/<slug>/design.html) covering user flows, screen states, and interaction contracts before task planning.\n\n\nplanner (planner.md)\nPeer Tech Lead under KISS: challenges unnecessary upstream complexity, creates the fewest cohesive tasks, and writes typed resumable STEPS in features/<slug>/tasks/tN-*.md.\n\n\ntask-executor (task-executor.md)\nImplements one exact dispatched task inside its authorized shape (Pending \u2192 Active \u2192 Ready for validation). Never marks its own work Done.\n\n\ntask-validator (task-validator.md)\nAudits the full upstream contract chain, git diff, and project regression test suite; writes features/<slug>/validation/tN-validation.json; alone marks delivery tasks Done.\n\n\ndebugger (debugger.md)\nInvestigates post-validation failures or user-reported bugs via hypothesis testing; writes durable defect reports (features/<slug>/defects/) and applies only localized authorized fixes.\n\n\ndoc-cleanup (doc-cleanup.md)\nCompacts completed task files and stale artifacts while preserving REQ acceptance evidence, monotonic task-index.yaml tombstones, and immutable decisions.\n\n\n\n\nRepository State Stores (In Your Project)\nSPIDER keeps all project memory in human-readable files committed alongside your code\u2014never trapped in proprietary cloud state or ephemeral chat logs:\nyour-project/\n\u251c\u2500\u2500 project.md                              # Hub: project overview, current state, and active/completed task table\n\u251c\u2500\u2500 requirements.md                         # Orchestrator-owned REQ/AC registry and validation evidence trail\n\u251c\u2500\u2500 decisions.md                            # Append-only architectural decision log (D1, D2, ...)\n\u251c\u2500\u2500 task-index.yaml                         # Machine-readable task state, REQ trace, and monotonic high-water mark\n\u251c\u2500\u2500 architecture/\n\u2502   \u251c\u2500\u2500 architecture.md                     # Living system architecture reference\n\u2502   \u2514\u2500\u2500 flows.md                            # Key runtime and protocol flows\n\u2514\u2500\u2500 features/\n    \u2514\u2500\u2500 <feature-slug>/\n        \u251c\u2500\u2500 requirements.md                 # Detailed requirement contract + confirmed minimum baseline\n        \u251c\u2500\u2500 blast-radius-summary.md         # Architect impact sweep & triage metadata\n        \u251c\u2500\u2500 build-plan.md                   # Component boundary & integration plan (when architecture changes)\n        \u251c\u2500\u2500 design.html                     # UI/UX specification (when ui_design_needed is true)\n        \u251c\u2500\u2500 tasks/\n        \u2502   \u2514\u2500\u2500 t1-<slug>.md                # Planner-authored task contract with GOAL, typed STEPS, NOW, and LOG\n        \u251c\u2500\u2500 validation/\n        \u2502   \u2514\u2500\u2500 t1-validation.json          # Structured validator audit report\n        \u2514\u2500\u2500 defects/\n            \u2514\u2500\u2500 bug-req-N-<slug>.md         # Debugger root-cause diagnosis report\n\n\nVerifying Bundle Integrity\nspider-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:\n# Verify the repository skill bundle\npython skills/spider-orchestrator/scripts/verify_specialist_skills.py --codex-home .\n\n# Run the 22-test behavioral regression suite\npython -m unittest discover -s skills/spider-orchestrator/scripts -v\n\nDocumentation\n\nProtocol Architecture (docs/architecture.md) \u2014 System layers, role boundaries, and core invariants.\nRouting & Repair Flows (docs/flows.md) \u2014 Fast path vs. deep triage, closed repair loops, taskless defect intake, and Done revalidation audits.\nEvolving Spider Terminology (docs/terminology.md) \u2014 Mental model mapping protocol concepts (Hub, Radials, Dragline, Sense \u2192 Spin \u2192 Wrap \u2192 Anchor).\nContributing Guide (CONTRIBUTING.md) \u2014 How to update role contracts and regenerate manifest hashes.\n\n\nBuilt in Production by Algoza Solutions\nSPIDER was created and battle-tested by Algoza Solutions to run disciplined, regression-checked AI software engineering across production codebases.\n\nHave 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?\nDrop us an email at info@algozasolutions.com \u2014 we harden fragile codebases, fix security gaps, and manage ongoing development with SPIDER's regression-gated workflow so new changes never break existing features.\n\n\nLicense\nReleased under the MIT License. Copyright \u00a9 2026 Algoza Solutions (OPC) Private Limited."
                ],
                "output": "readability",
                "pwd": "/data/archive/1793138714.675684",
                "schema": "ArchiveResult",
                "start_ts": "2026-10-27T22:06:29.180876+00:00",
                "status": "succeeded"
            }
        ],
        "screenshot": [],
        "singlefile": [],
        "title": [
            {
                "cmd": [
                    "curl",
                    "--silent",
                    "--location",
                    "--compressed",
                    "--max-time",
                    "120",
                    "--user-agent",
                    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) curl/curl 8.14.1 (x86_64-pc-linux-gnu)",
                    "https://github.com/Algoza-Solutions/spider-protocol"
                ],
                "cmd_version": "curl 8.14.1 (x86_64-pc-linux-gnu)",
                "end_ts": "2026-10-27T22:06:29.169747+00:00",
                "index_texts": null,
                "output": "GitHub - Algoza-Solutions/spider-protocol: Governed, regression-gated multi-agent software delivery protocol for Codex, Claude Code, OpenCode & Gemini CLI \u00b7 GitHub",
                "pwd": "/data/archive/1793138714.675684",
                "schema": "ArchiveResult",
                "start_ts": "2026-10-27T22:06:29.068510+00:00",
                "status": "succeeded"
            }
        ],
        "wget": [
            {
                "cmd": [
                    "wget",
                    "--no-verbose",
                    "--adjust-extension",
                    "--convert-links",
                    "--force-directories",
                    "--span-hosts",
                    "--no-parent",
                    "-e",
                    "robots=off",
                    "--reject=js,mjs,woff,woff2,ttf,otf,eot,mp4,m4v,mov,webm,ogv,mkv,avi,flv",
                    "--timeout=120",
                    "--restrict-file-names=windows",
                    "--page-requisites",
                    "--user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) wget/GNU Wget 1.21.3",
                    "--compression=auto",
                    "--timestamping",
                    "https://github.com/Algoza-Solutions/spider-protocol"
                ],
                "cmd_version": "GNU Wget 1.21.3",
                "end_ts": "2026-10-27T22:06:29.057863+00:00",
                "index_texts": null,
                "output": "github.com/Algoza-Solutions/spider-protocol.html",
                "pwd": "/data/archive/1793138714.675684",
                "schema": "ArchiveResult",
                "start_ts": "2026-10-27T22:06:20.877351+00:00",
                "status": "succeeded"
            }
        ]
    },
    "icons": null,
    "is_archived": true,
    "is_static": false,
    "latest": {
        "archive_org": null,
        "dom": null,
        "favicon": "favicon.ico",
        "git": null,
        "media": null,
        "pdf": null,
        "screenshot": null,
        "singlefile": null,
        "title": "GitHub - Algoza-Solutions/spider-protocol: Governed, regression-gated multi-agent software delivery protocol for Codex, Claude Code, OpenCode & Gemini CLI \u00b7 GitHub",
        "warc": null,
        "wget": "github.com/Algoza-Solutions/spider-protocol.html"
    },
    "link_dir": "/data/archive/1793138714.675684",
    "newest_archive_date": "2026-10-27T22:06:32.549832+00:00",
    "num_failures": 0,
    "num_outputs": 6,
    "oldest_archive_date": "2026-10-27T22:06:19.606603+00:00",
    "path": "/Algoza-Solutions/spider-protocol",
    "schema": "Link",
    "scheme": "https",
    "snapshot_id": "8c046a7e-acbd-4475-8179-cf9db32e064e",
    "sources": [
        "/data/sources/1793138714-import.txt"
    ],
    "tags": null,
    "tags_str": "",
    "timestamp": "1793138714.675684",
    "title": "GitHub - Algoza-Solutions/spider-protocol: Governed, regression-gated multi-agent software delivery protocol for Codex, Claude Code, OpenCode & Gemini CLI \u00b7 GitHub",
    "updated": "2026-10-27T22:06:19.604699+00:00",
    "updated_date": "2026-10-27 22:06",
    "url": "https://github.com/Algoza-Solutions/spider-protocol"
}