{"id":47863393,"url":"https://github.com/broomva/bstack","last_synced_at":"2026-05-28T06:10:54.742Z","repository":{"id":345374815,"uuid":"1185549253","full_name":"broomva/bstack","owner":"broomva","description":"Portable harness metalayer for AI-native development — irreducible primitives + 28 curated agent skills that turn any agent-driven workspace into a self-operating system. Install with: npx skills add broomva/bstack","archived":false,"fork":false,"pushed_at":"2026-05-20T23:58:33.000Z","size":508,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T02:19:23.164Z","etag":null,"topics":["agent-skills","ai-agent","autonomous-agents","broomva-stack","bstack","bstack-platform","cli","developer-tools","github-template","skills-sh"],"latest_commit_sha":null,"homepage":"https://broomva.tech/writing/bstack-portable-harness-metalayer","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/broomva.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-18T17:43:11.000Z","updated_at":"2026-05-20T23:58:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/broomva/bstack","commit_stats":null,"previous_names":["broomva/bstack"],"tags_count":27,"template":true,"template_full_name":null,"purl":"pkg:github/broomva/bstack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broomva%2Fbstack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broomva%2Fbstack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broomva%2Fbstack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broomva%2Fbstack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/broomva","download_url":"https://codeload.github.com/broomva/bstack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broomva%2Fbstack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33596384,"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-05-28T02:00:06.440Z","response_time":99,"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":["agent-skills","ai-agent","autonomous-agents","broomva-stack","bstack","bstack-platform","cli","developer-tools","github-template","skills-sh"],"created_at":"2026-04-03T23:56:02.513Z","updated_at":"2026-05-28T06:10:54.737Z","avatar_url":"https://github.com/broomva.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bstack — The Broomva Stack\n\n**A portable harness metalayer for AI-native development.** Eleven irreducible primitives plus 28 curated agent skills that turn any agent-driven workspace into a self-operating system.\n\n```bash\nnpx skills add broomva/bstack\n```\n\nThis installs the meta-skill that bootstraps the full stack — primitive contract, governance scaffolding, hooks, and skill roster — into your project. Works with Claude Code, Codex, Gemini CLI, OpenCode, and the [50+ agent CLIs the skills ecosystem supports](https://github.com/vercel-labs/skills).\n\n## The eleven primitives\n\nEach primitive closes one specific failure mode that drifts into entropy in unsupervised agent sessions.\n\n| # | Primitive | Closes |\n|---|---|---|\n| **P1** | Conversation Bridge | session amnesia |\n| **P2** | Control Gate | destructive ops the model didn't authorize |\n| **P3** | Linear Tickets | invisible work |\n| **P4** | PR Pipeline | merging unreviewed code |\n| **P5** | Parallel Agents | sequential bottleneck on independent tasks |\n| **P6** | Knowledge Bookkeeping | knowledge graph rot |\n| **P7** | Skill Freshness Check | silent rot of `npx skills add` snapshots |\n| **P8** | Branch + Worktree Janitor | squash-merged branches and dead worktrees accumulating |\n| **P9** | Productive Wait (`broomva/p9` skill) | sleep-on-wait dead time (CI, deploys, builds — PR CI is the canonical case) |\n| **P10** | Worktree Hygiene Discipline | dirty trees and orphan worktrees compounding across sessions |\n| **P11** | Empirical Feedback Loop | shipping code that compiles but doesn't actually work when exercised |\n\nFull reference with reflexive trigger rules, invariants, and cohesion narrative: **[references/primitives.md](references/primitives.md)**.\n\nP6, P9, P10, and P11 are *reasoning-enforced* — they bind every agent through reflexive trigger rules in `AGENTS.md` rather than through hooks. The other primitives are mechanism-enforced through hooks, scripts, or CI gates.\n\n## Stack layers (28 skills)\n\n| Layer | Skills | Purpose |\n|-------|--------|---------|\n| **Foundation** | [agentic-control-kernel](https://skills.sh/broomva/agentic-control-kernel), [control-metalayer-loop](https://skills.sh/broomva/control-metalayer-loop), [harness-engineering-playbook](https://skills.sh/broomva/harness-engineering-playbook), [p9](https://skills.sh/broomva/p9) | Safety shields, governance, deterministic workflow, CI watcher + productive-wait |\n| **Memory \u0026 Consciousness** | [agent-consciousness](https://skills.sh/broomva/agent-consciousness), [knowledge-graph-memory](https://skills.sh/broomva/knowledge-graph-memory), [prompt-library](https://skills.sh/broomva/prompt-library) | Three-substrate consciousness, persistent context |\n| **Orchestration** | [symphony](https://skills.sh/broomva/symphony), [symphony-forge](https://skills.sh/broomva/symphony-forge), [autoany](https://skills.sh/broomva/autoany) | Agent dispatch, scaffold CLI, EGRI self-improvement |\n| **Research \u0026 Intelligence** | [deep-dive-research-orchestrator](https://skills.sh/broomva/deep-dive-research-orchestrator), [skills](https://skills.sh/broomva/skills), [skills-showcase](https://skills.sh/broomva/skills-showcase) | Multi-dimensional research, skills inventory |\n| **Design \u0026 Implementation** | [arcan-glass](https://skills.sh/broomva/arcan-glass), [next-forge](https://skills.sh/broomva/next-forge) | BroomVA design system, Next.js production templates |\n| **Platform Specialties** | [alkosto-wait-optimizer](https://skills.sh/broomva/alkosto-wait-optimizer), [content-creation](https://skills.sh/broomva/content-creation), [finance-substrate](https://skills.sh/broomva/finance-substrate), seo-llmeo, brand-icons | Decision optimizer, content pipeline, finance, SEO/LLMEO, brand assets |\n| **Strategy \u0026 Decision Intel** | [pre-mortem](https://skills.sh/broomva/strategy-skills), [braindump](https://skills.sh/broomva/strategy-skills), [morning-briefing](https://skills.sh/broomva/strategy-skills), [drift-check](https://skills.sh/broomva/strategy-skills), [strategy-critique](https://skills.sh/broomva/strategy-skills), [stakeholder-update](https://skills.sh/broomva/strategy-skills), [decision-log](https://skills.sh/broomva/strategy-skills), [weekly-review](https://skills.sh/broomva/strategy-skills) | Strategic thinking, decision intelligence, personal productivity |\n\n## Commands\n\nOnce installed, the skill exposes six commands:\n\n- **`bootstrap`** — install all 28 skills + scaffold governance (CLAUDE.md, AGENTS.md, `.control/policy.yaml`) + wire hooks + run doctor\n- **`doctor`** — verify primitive contract compliance (always exits 0 by default; `--strict` for CI)\n- **`repair`** — apply targeted fixes for gaps the doctor surfaces\n- **`status`** — show installed-vs-missing skills + harness health\n- **`validate`** — check skill SKILL.md frontmatter health\n- **`revamp`** — full reconfiguration: force-reinstall + rewire + re-doctor\n\n## Governance \u0026 stability\n\nbstack's governance layer (`CLAUDE.md` + `AGENTS.md` + `.control/policy.yaml`) is the **Level 3 controller** in a [Recursive Controlled Systems hierarchy](https://broomva.tech/writing/recursive-controlled-systems) with formal stability proofs. The L3 stability margin is narrow on purpose — governance changes consume budget, so the contract evolves slowly and deliberately.\n\n| Level | System | Controller | Stability λ |\n|---|---|---|---|\n| L0 | External plant | Arcan agent loop | 1.455 |\n| L1 | Agent internal | Autonomic homeostasis controller | 0.411 |\n| L2 | Meta-control | EGRI loop engine | 0.069 |\n| **L3** | **Governance** | **CLAUDE.md + AGENTS.md + policy.yaml** | **0.006** |\n\nComposite stability: λᵢ \u003e 0 at all levels ⟹ exponentially stable.\n\n## Browse the full catalog\n\nInteractive catalog with descriptions, install commands, and layer diagrams:\n\n**[broomva.tech/skills](https://broomva.tech/skills)**\n\nThe narrative on what bstack is, why it exists, and what the eleven primitives buy you in measured throughput is at:\n\n**[broomva.tech/writing/bstack-portable-harness-metalayer](https://broomva.tech/writing/bstack-portable-harness-metalayer)**\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbroomva%2Fbstack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbroomva%2Fbstack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbroomva%2Fbstack/lists"}