{"id":48196729,"url":"https://github.com/alo-exp/silver-bullet","last_synced_at":"2026-06-14T02:09:31.205Z","repository":{"id":348216756,"uuid":"1196975088","full_name":"alo-exp/silver-bullet","owner":"alo-exp","description":"Agentic Process Orchestrator for AI-native Software Engineering \u0026 DevOps. Composes SB+GSD workflows with cross-plugin sequencing, traceability, quality gates, and hook-enforced delivery for Claude Code and Codex.","archived":false,"fork":false,"pushed_at":"2026-06-08T11:05:09.000Z","size":30422,"stargazers_count":5,"open_issues_count":5,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-08T11:27:38.755Z","etag":null,"topics":["agentic-process-orchestrator","ai","ai-agents","ai-development","ai-native","claude-code","claude-code-plugin","claude-plugin","codex","developer-tools","devops","gsd","infrastructure-as-code","llm","process-orchestrator","quality-gates","silver-bullet","software-engineering","workflow-automation","workflow-enforcement"],"latest_commit_sha":null,"homepage":"https://sb.alolabs.dev","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alo-exp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-31T08:04:04.000Z","updated_at":"2026-06-08T06:53:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alo-exp/silver-bullet","commit_stats":null,"previous_names":["alo-exp/dev-workflows","alo-exp/silver-bullet"],"tags_count":126,"template":false,"template_full_name":null,"purl":"pkg:github/alo-exp/silver-bullet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alo-exp%2Fsilver-bullet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alo-exp%2Fsilver-bullet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alo-exp%2Fsilver-bullet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alo-exp%2Fsilver-bullet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alo-exp","download_url":"https://codeload.github.com/alo-exp/silver-bullet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alo-exp%2Fsilver-bullet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34306790,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-process-orchestrator","ai","ai-agents","ai-development","ai-native","claude-code","claude-code-plugin","claude-plugin","codex","developer-tools","devops","gsd","infrastructure-as-code","llm","process-orchestrator","quality-gates","silver-bullet","software-engineering","workflow-automation","workflow-enforcement"],"created_at":"2026-04-04T18:07:46.682Z","updated_at":"2026-06-14T02:09:31.199Z","avatar_url":"https://github.com/alo-exp.png","language":"HTML","funding_links":[],"categories":["Source Catalog"],"sub_categories":[],"readme":"# Silver Bullet\n\n[![version](https://img.shields.io/badge/version-v0.39.3-blue)](https://github.com/alo-exp/silver-bullet/releases/tag/v0.39.3)\n[![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\n**Agentic Process Orchestrator for AI-native Software Engineering and DevOps.**\n\nSilver Bullet is the lifecycle orchestration and enforcement layer for AI-native\nsoftware engineering. It owns the core project flow: intent routing, context,\nplanning, execution, verification, review, security, documentation, shipping,\nand release discipline. Hook-backed gates keep agents from skipping required\nsteps before code, PRs, deploys, or releases.\n\nPlain version: describe what you want to do. Start with `/silver`. Silver Bullet\nclassifies the task, composes the right SB-owned workflow, and records the\nevidence needed to continue safely.\n\n\u003e \"There is no single development, in either technology or management technique,\n\u003e which by itself promises even one order-of-magnitude improvement...\" -\n\u003e Fred Brooks, 1986\n\nBrooks was right. Silver Bullet is not one magic technique. It is the coordinated\nprocess layer that makes AI-native delivery less dependent on agent memory and\noperator vigilance.\n\n## What Silver Bullet Adds\n\nSilver Bullet now owns the knowledge-work and lifecycle behaviors it explicitly\ndepends on as SB-owned skills. Optional plugins remain\nuseful when they extend SB into DevOps, provider, data, documentation, or\ntool-specific domains, but they are no longer required for the core software\nengineering lifecycle.\n\n| Area | Silver Bullet owns |\n|------|--------------------|\n| Entry point | `/silver` routes freeform work into a task-shaped workflow |\n| Workflow shape | Dynamic composition from 18 atomic flows |\n| Process discipline | Hook-enforced, state-tracked lifecycle evidence |\n| Quality | Product, security, DevOps, docs, UAT, CI, and release gates |\n| Delivery safety | Mechanical blocks on unsafe edits, PRs, deploys, and releases |\n| Continuity | Session logs, handoff, issue capture, knowledge capture, anti-stall checks, and forensics |\n\n## Current Positioning\n\nSilver Bullet is an **Agentic Process Orchestrator (APO)**:\n\n- **Agentic**: built for AI coding agents that can forget, shortcut, overfit, or\n  over-trust their own prior context.\n- **Process**: turns SDLC discipline into explicit flows, artifacts, and gates.\n- **Orchestrator**: chooses and sequences the right tools for the task instead of\n  forcing every task through one rigid workflow.\n\nSilver Bullet can still call optional extension plugins when a selected workflow\nneeds a domain-specific capability, especially DevOps/provider tools. It does not\nuse lifecycle-overlap knowledge-work plugins as default lifecycle dependencies.\n\n## How It Works\n\nYou normally start with:\n\n```text\n/silver improve the account settings page and ship it safely\n```\n\nThe router classifies the request, displays the selected route, and invokes the\nappropriate SB-owned workflow. Examples:\n\n| Intent | Typical route | Why |\n|--------|---------------|-----|\n| Build or enhance a feature | `silver:feature` | Runs SB context, planning, execution, review, verification, and ship |\n| Fix a regression | `silver:bugfix` | Inserts debug/TDD before the normal lifecycle |\n| Work on UI | `silver:ui` | Adds SB design contract and UI quality review around execution |\n| Change infrastructure | `silver:devops` | Adds blast radius, IaC gates, promotion, and rollback discipline |\n| Research a decision | `silver:research` | Produces a decision artifact before implementation |\n| Prepare a release | `silver:release` | Runs documentation, UAT, milestone, release, and publication gates |\n| Make a small safe edit | `silver:fast` | Routes low-risk work through a lighter path |\n| Explicit legacy lifecycle request | SB equivalent by default | Legacy lifecycle names are compatibility routes unless the user explicitly asks for an external plugin |\n\n### Dynamic Composition, Not A Fixed Script\n\nSilver Bullet starts from two workflow families, then composes the exact flow\nchain needed for the task:\n\n| Workflow family | Use for | Composition surface |\n|-----------------|---------|---------------------|\n| `full-dev-cycle` | Applications, APIs, CLIs, libraries, plugin work | Clarify, specify, plan, execute, review, secure, verify, document, ship, release |\n| `devops-cycle` | Terraform, Kubernetes, Helm, CI/CD, cloud, ops | Incident path, blast radius, IaC quality, environment promotion, deploy/rollback, release |\n\nThe canonical flow catalog lives in\n[docs/composable-flows-contracts.md](docs/composable-flows-contracts.md). It\ncontains 18 atomic flows:\n\n```text\nBOOTSTRAP -\u003e ORIENT -\u003e CLARIFY -\u003e DECIDE -\u003e SPECIFY -\u003e PLAN\n-\u003e DESIGN CONTRACT -\u003e EXECUTE -\u003e UI QUALITY -\u003e REVIEW -\u003e SECURE\n-\u003e VERIFY -\u003e QUALITY GATE -\u003e SHIP -\u003e DEBUG -\u003e DESIGN HANDOFF\n-\u003e DOCUMENT -\u003e RELEASE\n```\n\n`/silver` includes only the flows whose prerequisites and triggers apply. For\nexample, a UI bugfix can include DEBUG, DESIGN CONTRACT, EXECUTE, UI QUALITY,\nREVIEW, VERIFY, and SHIP without pretending every task needs a release flow.\n\n## Enforcement Model\n\nSilver Bullet is intentionally more than instructions in a README. It installs\nhooks that observe real tool usage and state transitions.\n\nCommon examples:\n\n```text\nHARD STOP - Planning incomplete.\nMissing: silver-quality-gates, silver-context, silver-plan\nRun the missing planning steps before editing source code.\n```\n\n```text\nCOMPLETION BLOCKED - Workflow incomplete.\nFinal delivery requires review, security, validation, test freshness,\nrelease readiness, and ship markers before PR/deploy/release commands proceed.\n```\n\n```text\nSilver Bullet: 8 steps | PLANNING 3/3 | REVIEW 1/3 | FINALIZATION 0/4\nNext: silver-review-request\n```\n\n### Two-Tier Delivery Discipline\n\nSilver Bullet deliberately does not block every useful intermediate commit.\n\n- **Planning floor**: source edits and intermediate development commits require\n  the selected SB pre-execution chain.\n- **Final delivery floor**: PR creation, deploy commands, release commands, and\n  completion claims require the broader review/security/validation/test/release\n  chain.\n\nThis keeps incremental work viable while still blocking premature final\ndelivery.\n\n### Enforcement Layers\n\n| Layer | Hook or surface | Purpose |\n|-------|-----------------|---------|\n| 1 | `record-skill.sh` | Records completed SB and optional helper skill invocations |\n| 2 | `record-requested-skill.sh` | Records requested `/silver` routes before work starts |\n| 3 | `prompt-reminder.sh` | Re-injects missing steps and core rules before each user prompt |\n| 4 | `dev-cycle-check.sh` | Blocks source edits before the required planning floor |\n| 5 | `workflow-chain-guard.sh` | Blocks active composed workflows when downstream lifecycle markers are missing |\n| 6 | `dependency-skill-check.sh` | Fails closed when required SB or optional extension skills are unavailable |\n| 7 | `planning-file-guard.sh` | Blocks direct edits to SB-owned planning artifacts |\n| 8 | `completion-audit.sh` | Blocks PR/deploy/release and selected delivery commands when final gates are missing |\n| 9 | `ci-status-check.sh` | Blocks push, PR, and release while CI is red; commit remains warning-only so CI fixes are possible |\n| 10 | `stop-check.sh` | Blocks task-complete declarations when required gates are missing |\n| 11 | `uat-gate.sh` and `spec-floor-check.sh` | Enforce minimum spec and UAT evidence before lifecycle completion |\n| 12 | `forbidden-skill-check.sh`, `instruction-file-guard.sh`, `trivial-file-guard.sh` | Protect against deprecated paths, unsafe instruction-file creation, and legacy bypass abuse |\n\nAdditional support hooks handle session logging, timeout/stall warnings,\nsemantic compression, roadmap freshness, PR traceability, phase archive safety,\nand compliance status.\n\nHook-backed enforcement requires a runtime that supports the relevant hook\nevents. In less capable runtimes, Silver Bullet can still provide workflow\nguidance, but hard blocks depend on host support.\n\n## Runtime Support\n\n| Runtime | Status | Notes |\n|---------|--------|-------|\n| Claude Code | Primary plugin runtime | Uses Claude plugin skills, commands, and hooks |\n| Codex | Supported package runtime | Uses an SB-only Codex package and native `/Silver:` skill mirror |\n| Kay | Tested agent for isolated live testing | Used for isolated live testing via MiniMax.io with `MiniMax-M3` |\n\nSilver Bullet's Codex package intentionally contains only SB-owned surfaces:\nskills, hooks, templates, commands, and helper scripts. Optional extension\nplugins are installed separately only when the user explicitly needs their\ndomain-specific capabilities.\n\n## Install\n\nInstall `jq` first:\n\n```bash\nbrew install jq\n# or\nsudo apt install jq\n```\n\n### Claude Code\n\nInstall Graphify and Silver Bullet:\n\n```text\n/shell uv tool install graphifyy\n/plugin install alo-exp/silver-bullet\n```\n\nThen open a project and run:\n\n```text\n/silver:init\n```\n\n### Codex\n\nFor normal use, install or refresh Silver Bullet from the public Codex\nmarketplace. The published package exposes SB through the native `/Silver:`\npicker namespace, keeps internal `skill-source/` files hidden from duplicate\nplugin listings, and wires hooks through the package manifest.\n\nFor local development from this repository checkout, use the same installer with\nlegacy cleanup enabled:\n\n```bash\n./scripts/install-codex.sh --purge-legacy-skills\n```\n\nThe installer:\n\n- syncs the curated SB-only Codex bundle in `plugins/silver-bullet/`\n- registers the shared `alo-labs/codex-plugins` marketplace\n- keeps `/silver` and `/silver:*` in the main Silver Bullet package\n- includes the packaged `scripts/workflows.sh` helper used by composed workflow\n  tracking\n- includes the `scripts/silver-bullet invoke-skill \u003cname\u003e` Codex adapter so\n  required skills can be invoked and recorded without a Claude-only `Skill` tool\n- enables SB only when the current working directory is an actual SB project\n  root (`.silver-bullet.json` plus `silver-bullet.md`)\n- does not install or enable lifecycle-overlap plugins for core SB workflows\n- purges stale SB user-level hook entries so unrelated Codex projects do not get\n  Silver Bullet hooks\n- seeds Codex hook trust from the installed plugin manifest instead of\n  duplicating SB hooks into the user's global hook cache\n\nFor isolated Codex-compatible live testing, Kay `v0.9.6` plus MiniMax.io\nwith `MiniMax-M3` is the tested route. The live harness creates a\ntemporary `KAY_HOME` root so tests do not rewrite the user's real Kay or Codex\nhook cache.\n\n### Optional DevOps Plugins\n\nThe `devops-cycle` works without optional DevOps plugins, but these enrich\nprovider-specific work when installed:\n\n```text\n/plugin marketplace add hashicorp/agent-skills\n/plugin marketplace add awslabs/agent-plugins\n/plugin marketplace add pulumi/agent-skills\n/plugin marketplace add ahmedasmar/devops-claude-skills\n/plugin marketplace add wshobson/agents\n```\n\nSilver Bullet detects installed DevOps plugins during `/silver:init` and records\navailability in `.silver-bullet.json`.\n\n## Project Initialization\n\nRun this once in a project:\n\n```text\n/silver:init\n```\n\nIt will:\n\n- detect project name, source paths, stack, and workflow type\n- create or update `.silver-bullet.json`\n- create `silver-bullet.md` from `templates/silver-bullet.md.base`\n- reconcile existing host instruction files (`CLAUDE.md` in Claude, `AGENTS.md`\n  in Codex) without overwriting user-owned content\n- copy workflow docs into `docs/workflows/`\n- scaffold the documentation scheme and durable knowledge/learnings folders\n- initialize or connect SB planning artifacts\n- set up enforcement state paths under `${SB_RUNTIME_HOME_ROOT}/.silver-bullet/`\n\nAfter that, use `/silver` for normal work.\n\n## Built-In Skills And Routes\n\n| Route or skill | Purpose |\n|----------------|---------|\n| `/silver` | Main natural-language router and APO entry point |\n| `/silver:init` | Project setup, SB lifecycle checks, config, workflow docs, doc scheme |\n| `/silver:feature` | Feature workflow through SB-owned lifecycle |\n| `/silver:bugfix` | Debug/TDD-oriented bugfix workflow |\n| `/silver:ui` | UI workflow with design contract and UI quality gates |\n| `/silver:devops` | Infrastructure workflow with blast radius and IaC gates |\n| `/silver:deploy` | Deployment workflow with platform detection, health checks, rollback evidence, and runtime handoff |\n| `/silver:canary` | Post-deploy runtime watch for HTTP/browser/log/metric evidence |\n| `/silver:research` | Research and decision workflow |\n| `/silver:spec` | Spec and requirements elicitation |\n| `/silver:ingest` | External artifact ingestion with manifest review |\n| `/silver:validate` | Gap analysis and validation before implementation or release |\n| `/silver:release` | Release preparation workflow |\n| `/silver:create-release` | Final release artifact creation after SB release readiness |\n| `/silver:fast` | Small, low-risk work through a routed fast path |\n| `/silver:test` | Test writing, E2E discovery, test repair, test audit, test performance, and mutation challenge workflow |\n| `/silver:refactor` | Behavior-preserving refactor workflow with baseline proof |\n| `/silver:worktree` | Isolated git worktree create/finish workflow |\n| `/silver:content` | Public content, docs, migration, SEO/AI-search, optimization, and article workflow |\n| `/silver:benchmark` | Repeatable benchmark workflow for agents, models, providers, prompts, or approaches |\n| `/silver:ensure-docs` | Documentation scheme bootstrap, reconciliation, and recovery |\n| `/silver:scan` | Retrospective session scan for deferred issues and insights |\n| `/silver:add` | File an issue or backlog item |\n| `/silver:remove` | Remove or close an issue/backlog item |\n| `/silver:rem` | Capture knowledge or learnings |\n| `/silver:handoff` | Create a project-level handoff prompt |\n| `/silver:forensics` | Reconstruct failed, stalled, or abandoned sessions |\n| `/silver:incident` | Incident response, postmortem, recovery verification, and corrective-action tracking |\n| `/silver:retro` | Engineering retrospective over releases, incidents, dates, or workflow history |\n| `/silver:quality-gates` | Product/software quality assessment |\n| `/silver:domain-audit` | Specialized domain quality contracts for code, tests, API, data, dependencies, performance, structure, CI, environment, accessibility, content/search, UI, architecture, runtime, incident, retro, and benchmark evidence |\n| `/silver-blast-radius` | DevOps change-impact and rollback assessment |\n| `/devops-quality-gates` | IaC quality assessment |\n| `/devops-skill-router` | Selects optional DevOps plugin skills for the current toolchain |\n| `/verify-tests` | Runs configured verification commands or stack defaults and writes a freshness marker |\n\nWorkflow contracts use logical names such as `silver:feature`. In Codex, SB\nmirrors its packaged `skill-source/` files into the native `~/.codex/skills`\nsurface so the picker shows a single `/Silver:` namespace instead of plugin\nprefixed duplicates.\n\nIn Codex, use `silver-bullet invoke-skill \u003cname\u003e` when SB requires a recorded\nskill invocation and the runtime has no callable `Skill` tool. Directly reading\n`SKILL.md` is loaded-only metadata and does not satisfy workflow gates.\n\n## Configuration\n\nProject config lives in `.silver-bullet.json`. The default source of truth is\n[templates/silver-bullet.config.json.default](templates/silver-bullet.config.json.default).\n\nMinimal shape:\n\n```json\n{\n  \"config_version\": \"0.39.0\",\n  \"version\": \"0.39.0\",\n  \"project\": {\n    \"name\": \"my-app\",\n    \"src_pattern\": \"/src/\",\n    \"src_exclude_pattern\": \"__tests__|\\\\.test\\\\.\",\n    \"active_workflow\": \"full-dev-cycle\"\n  },\n  \"skills\": {\n    \"required_planning\": [\n      \"silver-quality-gates\",\n      \"silver-context\",\n      \"silver-plan\"\n    ],\n    \"required_deploy\": [\n      \"silver-quality-gates\",\n      \"silver-context\",\n      \"silver-plan\",\n      \"silver-execute\",\n      \"silver-verify\",\n      \"silver-ship\",\n      \"silver-review\",\n      \"silver-secure\",\n      \"silver-validate\",\n      \"silver-review-request\",\n      \"silver-review-triage\",\n      \"silver-branch-finish\",\n      \"silver-create-release\",\n      \"silver-completion-audit\",\n      \"silver-tdd\",\n      \"verify-tests\"\n    ]\n  },\n  \"state\": {\n    \"state_file\": \"${SB_RUNTIME_HOME_ROOT}/.silver-bullet/state\",\n    \"trivial_file\": \"${SB_RUNTIME_HOME_ROOT}/.silver-bullet/trivial\"\n  },\n  \"release\": {\n    \"profile\": \"generic\",\n    \"require_plugin_runtime_matrix\": true,\n    \"require_pre_release_quality_gate\": true,\n    \"quality_gate_state_file\": \"${SB_RUNTIME_HOME_ROOT}/.silver-bullet/quality-gate-state\"\n  }\n}\n```\n\nImportant fields:\n\n| Field | Meaning |\n|-------|---------|\n| `project.src_pattern` | Regex for files that count as source and trigger enforcement |\n| `project.src_exclude_pattern` | Regex for source-like files excluded from implementation gates |\n| `project.active_workflow` | `full-dev-cycle` or `devops-cycle` |\n| `skills.required_planning` | Planning floor before implementation work |\n| `skills.required_planning_devops` | DevOps-specific planning floor |\n| `skills.required_deploy` | Final delivery floor for PR/deploy/release |\n| `skills.all_tracked` | Canonical list of skill markers hooks record |\n| `devops_plugins` | Optional DevOps plugin availability detected by init |\n| `release.require_plugin_runtime_matrix` | Mandatory live runtime release gate for plugin projects |\n| `release.require_pre_release_quality_gate` | Mandatory 4-stage pre-release quality gate |\n| `semantic_compression` | TF-IDF context compression settings for large files |\n\nDownstream projects normally use the generic release profile. This repository\nrequires plugin-runtime live matrices and the 4-stage pre-release gate because\nSilver Bullet itself is a Claude/Codex plugin.\n\n## Documentation Governance\n\nSilver Bullet treats documentation as a delivery artifact, not an afterthought.\n\n`/silver:init` scaffolds a doc scheme from\n[templates/doc-scheme.md.base](templates/doc-scheme.md.base). The hooks then\ncheck that required docs are present and current when delivery commands run. The\nrelease flow expects README, changelog, architecture/testing/release docs, and\nworkflow docs to match the current product surface.\n\nUseful docs:\n\n- [docs/PRD-Overview.md](docs/PRD-Overview.md) - product overview\n- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) - system architecture\n- [docs/ENFORCEMENT.md](docs/ENFORCEMENT.md) - enforcement details\n- [docs/SDLC-MAP.md](docs/SDLC-MAP.md) - SDLC coverage matrix\n- [docs/composable-flows-contracts.md](docs/composable-flows-contracts.md) -\n  canonical flow contracts\n- [docs/internal/sb-benefits-over-plain-gsd.md](docs/internal/sb-benefits-over-plain-gsd.md) -\n  legacy comparison retained for migration context\n\n## Testing\n\nRun the normal suite:\n\n```bash\nbash scripts/verify-tests.sh\n```\n\nThat runs hook unit tests, script unit tests, integration scenarios, E2E harness\nsanity checks, and coverage matrix checks. Current release baseline:\n\n```text\n2,025 passed, 0 failed\n```\n\nRun live runtime tests when validating plugin/runtime behavior:\n\n```bash\nbash tests/live/run-live-tests.sh\nbash tests/e2e-live/run-e2e-live-tests.sh\n```\n\nLimit live tests to one runtime:\n\n```bash\nSB_LIVE_RUNTIMES=codex bash tests/live/run-live-tests.sh\nSB_E2E_LIVE_RUNTIMES=codex bash tests/e2e-live/run-e2e-live-tests.sh\n```\n\nCodex-compatible live tests use Kay `v0.9.6` with the MiniMax.io provider and\n`MiniMax-M3` when configured.\nSB tests should not be run against the upstream `codex` binary directly.\nThe harness isolates config roots so live tests do not mutate the user's normal\nCodex hook cache.\n\n## CI/CD And Release Gates\n\nFor downstream deploy pipelines, use:\n\n```bash\nbash scripts/deploy-gate-snippet.sh\n```\n\nThe snippet checks the workflow state file and blocks deploys if required\ndelivery skills are missing.\n\nRelease behavior:\n\n- `git commit` is warning-only for red CI, so CI fixes can be committed.\n- `git push`, `gh pr create`, and `gh release create` are blocked when CI is red.\n- `gh release create` can require plugin live matrices and the pre-release\n  quality-gate markers when the project release profile opts in.\n- The SB plugin repo requires the shared live matrix, todo-app live E2E marker,\n  inline full-surface marker, 4-stage pre-release gate, and a fresh full-suite\n  rerun before release.\n\n## Repository Layout\n\n```text\ncommands/                         Codex/Claude command surfaces\nskills/                           Source SB skills\nhooks/                            Runtime enforcement hooks\nscripts/                          Installers, workflow helpers, verification tools\ntemplates/                        Project config, instruction, workflow, and docs templates\ndocs/                             Product, architecture, enforcement, testing, release docs\nsite/                             Public website and Help Center\nplugins/silver-bullet/            Codex package surface, mostly symlinks to source\ntests/                            Unit, integration, live, and E2E harnesses\n.claude-plugin/                   Claude plugin marketplace metadata\n.planning/                        SB project lifecycle artifacts for this repo\n```\n\nThe Codex package mostly symlinks source-owned assets into `plugins/silver-bullet/`, stores internal generated skill files under `skill-source/`, and mirrors those files into native `~/.codex/skills` during install so the picker exposes only the `/Silver:` namespace.\nProject-instance artifacts such as `.planning/` and `.claude/`, and\nruntime state are not treated as plugin package content.\n\n## Troubleshooting\n\n| Symptom | Fix |\n|---------|-----|\n| `jq not found` | Install `jq` with Homebrew or apt |\n| `/silver` not available in Claude Code | Install the plugin and restart/reload the Claude Code session |\n| `/Silver:` entries not available in Codex | Refresh the public Codex marketplace install, or run `./scripts/install-codex.sh --purge-legacy-skills` from a repo checkout when developing SB itself |\n| Graphify missing | Install with `uv tool install graphifyy` or `pip install graphifyy`; SB falls back to direct docs reads only as a degraded path |\n| Legacy lifecycle plugin missing | No action needed for core SB workflows; use SB-owned `silver:*` skills |\n| Hooks not firing | Confirm `.silver-bullet.json` and `silver-bullet.md` both exist in the project root |\n| Too many files trigger enforcement | Adjust `project.src_pattern` and `project.src_exclude_pattern` |\n| YAML/JSON edits are unexpectedly gated | In `devops-cycle`, YAML/JSON/TOML are infrastructure code and intentionally gated |\n| CI is red and you need to push a fix | Commit normally; for push use the explicit CI override marker only when fixing CI: `touch ${SB_RUNTIME_HOME_ROOT}/.silver-bullet/ci-red-override` |\n| Want to refresh templates | Re-run `/silver:init`; it detects existing config and preserves project-owned content |\n| Want to start fresh | Remove `.silver-bullet.json` and `silver-bullet.md`, then rerun `/silver:init` |\n\n## Current Release\n\n- Version: `0.39.0`\n- Release: [v0.39.0](https://github.com/alo-exp/silver-bullet/releases/tag/v0.39.0)\n- Notable changes:\n  - SB now owns the core context, plan, execute, review, security, verify, ship, TDD, and completion-audit lifecycle skills it enforces.\n  - Legacy knowledge-work skills are compatibility or explicit optional tools, not core runtime dependencies.\n  - Default config schema moved to `0.39.0` so older lifecycle dependency lists are normalized during migration.\n  - Public docs, Help Center, marketplace metadata, and release gates now describe the SB-owned lifecycle model.\n\n## License\n\nMIT - [Alo Labs](https://alolabs.dev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falo-exp%2Fsilver-bullet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falo-exp%2Fsilver-bullet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falo-exp%2Fsilver-bullet/lists"}