https://github.com/broomva/autonomous

bstack full-discipline operating mode — workspace operationalization of broomva.tech/prompts/autonomous-senior-engineer. Compounds universal role contract with the 16-primitive bstack discipline.
https://github.com/broomva/autonomous

agent-skill autonomous broomva bstack canonical-mode claude-code operating-mode p14 p15 p16

Last synced: 6 days ago
JSON representation

bstack full-discipline operating mode — workspace operationalization of broomva.tech/prompts/autonomous-senior-engineer. Compounds universal role contract with the 16-primitive bstack discipline.

• Host: GitHub
• URL: https://github.com/broomva/autonomous
• Owner: broomva
• License: mit
• Created: 2026-05-12T16:40:43.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-05-13T23:25:30.000Z (about 1 month ago)
• Last Synced: 2026-05-13T23:36:23.873Z (about 1 month ago)
• Topics: agent-skill, autonomous, broomva, bstack, canonical-mode, claude-code, operating-mode, p14, p15, p16
• Size: 31.3 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# autonomous

[![validate](https://github.com/broomva/autonomous/actions/workflows/validate.yml/badge.svg)](https://github.com/broomva/autonomous/actions/workflows/validate.yml)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

[![Skills.sh](https://img.shields.io/badge/skills.sh-broomva%2Fautonomous-blue)](https://skills.sh/broomva/autonomous)

[![bstack](https://img.shields.io/badge/bstack-canonical%20mode-orange)](https://github.com/broomva/bstack)

> **bstack full-discipline operating mode.** Replaces the daily ritual sentence ("do this, document, be autonomous, ensure CICD checks green, work with parallel agents, think deeply through chain of dependencies, address PR comments, update docs, complete autonomously") with one invocation.

## Quick start

```bash

npx skills add broomva/autonomous

```

Then in your agent session, invoke when the user has agreed on a plan and wants execution:

- **Explicit**: `/autonomous`

- **Bare directives**: "go", "proceed", "be autonomous", "merge autonomously", "automerge", "all green"

- **Selection from options**: "yes, option A", "let's do that"

## What it does

When invoked, the agent runs a 20-step pipeline that fires every bstack reflex without further prompting:

- **Pre-flight:** state snapshot (P15), dep-chain trace (P14), worktree decision (P10), validation plan (P11), long-horizon check (P12)

- **Plan:** Linear ticket (P3), parallel decomposition (P5)

- **Execution:** empirical watchers (P11), research-before-implement (Context7), docs before push

- **Pre-push:** smoke tests, bookkeeping reflex (P6)

- **PR + merge:** PR with Linear ID (P4), CI watcher (P7), PR comment loop, auto-merge when gates pass

- **Post-merge:** janitor (P9, P10), dogfood receipt (P11)

## Architecture — compounding pattern

This skill is the **workspace-specific operationalization** of the canonical [autonomous-senior-engineer prompt](https://broomva.tech/prompts/autonomous-senior-engineer). The prompt is universal (any repo); this skill grounds it in the bstack primitives of a bstack-enabled workspace.

The prompt sets the agent's stance. The skill says how that stance gets executed with these primitives. Together they're the discipline.

## Cardinal rule

> The user invokes `/autonomous` to *stop instructing the agent on bstack discipline*. Asking them "should I check git status? open the PR? auto-merge?" violates the contract. Disciplines are unconditional defaults.

## Reading order

1. **`SKILL.md`** — full skill content (role contract, 20-step pipeline, role-contract ↔ bstack mapping, anti-rationalization table A + dump-extracted table B, red flags, output contract)

2. **`https://broomva.tech/prompts/autonomous-senior-engineer`** — canonical universal role contract (embedded into SKILL.md, version-tracked)

3. **`~/broomva/AGENTS.md` §Bstack Core Automation Primitives** — the P1-P16 reference this skill composes with

## Verification

This skill follows the **TDD-for-skills doctrine** from [`superpowers:writing-skills`](https://github.com/anthropics/superpowers). Every `SKILL.md` change must verify against the pressure scenarios in [`tests/pressure-scenarios.md`](./tests/pressure-scenarios.md):

- **Scenario 1 — Moderate**: single-vector pressure (`ship /api/health`)

- **Scenario 2 — Stacked**: time + sunk cost + authority + local-verified (`3h debug, hotfix-merge, 20min until standup`)

- **Scenario 3 — Cross-repo trigger**: inverse-section concrete machine-checkable test

- **Scenario 4 — Public-API-break**: inverse-section AST-diff test

Loopholes don't get accepted; they get closed. See [`CONTRIBUTING.md`](./CONTRIBUTING.md) for the verification protocol.

## Contributing

We welcome contributions. The bar is high — every change is a discipline change that future agents will be bound by — but the process is approachable. See [`CONTRIBUTING.md`](./CONTRIBUTING.md).

Quick rules:

- All changes to `SKILL.md` must pass the pressure-scenario verification

- New anti-rationalization rows need the scenario that surfaced them (rule-of-three: ≥3 instances before crystallizing)

- The direction of evolution is *stricter*, not *looser*

## Security

This is a markdown skill — no executable code, no network calls. The trust boundary is the agent host, not the skill itself. Report security concerns per [`SECURITY.md`](./SECURITY.md).

## Changelog

See [`CHANGELOG.md`](./CHANGELOG.md). Notable releases:

- **v0.0.2** (2026-05-13) — 20-reflex pipeline; 4 rationalization surfaces closed; stacked-pressure test scenario added

- **v0.0.1** (2026-05-12) — Initial release; 19-reflex pipeline; embedded role contract from broomva.tech/prompts

## Related

- [`broomva/bstack`](https://github.com/broomva/bstack) — the substrate this skill operates on (16 primitives + 29 skills)

- [`broomva/persist`](https://github.com/broomva/persist) — bstack P12, long-horizon loop discipline

- [`broomva/p9`](https://github.com/broomva/p9) — bstack P7, productive-wait optimizer

- [`broomva/bookkeeping`](https://github.com/broomva/bookkeeping) — bstack P6, knowledge graph maintenance

- [`broomva.tech/prompts/autonomous-senior-engineer`](https://broomva.tech/prompts/autonomous-senior-engineer) — the universal role contract this skill operationalizes

## License

MIT — see [LICENSE](./LICENSE).