Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/quality.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ jobs:
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0
- run: ${{ matrix.timeout }} -k 5 270 cargo +1.95 nextest run --locked
- run: ${{ matrix.timeout }} -k 5 60 cargo +1.95 test --manifest-path fixtures/handoff/Cargo.toml --locked --tests
- run: ${{ matrix.timeout }} -k 5 60 cargo +1.95 test --manifest-path examples/spendcheck/Cargo.toml --locked --tests
- if: matrix.os == 'macos-14'
run: shasum -a256 target/debug/allstack > target/debug/allstack.sha256
- if: matrix.os == 'macos-14'
Expand Down Expand Up @@ -64,5 +65,7 @@ jobs:
tool: cargo-deny@0.19.2
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0
- run: timeout -k 5 60 cargo +1.95 fmt --all -- --check
- run: timeout -k 5 60 cargo +1.95 fmt --manifest-path examples/spendcheck/Cargo.toml -- --check
- run: timeout -k 5 90 cargo +1.95 deny check
- run: timeout -k 5 270 cargo +1.95 clippy --all-targets --locked -- -D warnings
- run: timeout -k 5 60 cargo +1.95 clippy --manifest-path examples/spendcheck/Cargo.toml --all-targets --locked -- -D warnings
44 changes: 35 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,46 @@
# Allstack

Plan, build, verify, and ship across coding agents, with durable history and evidence tied to the delivered change.
Opinionated product and engineering skills for Codex and Claude Code, backed by durable project memory and delivery evidence.

**Status: implementation preview.** The Rust CLI implements local run storage, task coordination, host invocation, immutable handoffs, verification, and GitHub publication. Source-level support is distinct from release proof: use the [acceptance scenarios](docs/reference/release-acceptance.md) to audit actual host journeys, interruptions, and delivered artifacts.
**Status: implementation preview.** Invoke native skills to shape an idea, plan a change, review an existing branch, exercise an application, or ship authorized work. AllSource, Chronis, and Prime support durable continuation underneath. Source support and real-host acceptance are tracked separately in the [documentation](docs/README.md).

The [verification report](docs/reports/2026-10-24-cross-host-workflow-verification.md) records authenticated host execution, delivered forward-run evidence, reverse handoff observations, and supported limits. Private gate receipts remain readable through `allstack evidence <run>`; source-linked Prime context through `allstack recall <query>`.

Allstack embeds [AllSource Core](https://github.com/all-source-os/all-source) 0.26.1 for run history and Prime graph storage, and calls Chronis through `cn --toon` for task state. Prime recall is local lexical matching over delivery nodes; vector search and hosted synchronization are outside this preview. Coding agents remain responsible for model execution. The first release targets Codex CLI and Claude Code on one Unix machine, with an explicit handoff between them.

## First complete job

A developer plans a change in one host, continues implementation in another, resumes after an interruption, verifies the exact resulting commit, and publishes one reviewable pull request. The next host recovers the plan, workspace snapshot, evidence, and outstanding actions without copying a conversation transcript.
A developer shapes an application change, reviews its architecture, implements it, checks concrete failure risks, exercises the real user flow, and publishes one verified PR. Each specialist also works independently. An explicit host change preserves the accepted plan, candidate, ownership, and outstanding checks without copying a conversation transcript.

In this workflow, **ship means a verified commit pushed to a feature branch and an open pull request**. Merge and deployment are separate actions.

## Component boundaries
## Start in your coding host

Install the CLI from a reviewed checkout with Rust 1.95 or later:

```sh
cargo install --path . --locked
allstack -C /path/to/project init --skills-only --check
allstack -C /path/to/project init --skills-only
```

Then invoke a skill by name. Codex accepts `$allstack-plan`; Claude Code accepts `/allstack-plan`. Existing sessions may need reopening for skill discovery.

| Skill | Complete job |
| --- | --- |
| `allstack-shape` | Challenge demand, alternatives, and the outcome worth building. |
| `allstack-plan` | Resolve architecture, failure behavior, compatibility, and acceptance. |
| `allstack-review` | Find evidenced defects in an existing branch, diff, or PR. |
| `allstack-qa` | Exercise the actual UI, API, CLI, or job using available tools. |
| `allstack-ship` | Verify and publish the authorized change through managed delivery. |
| `allstack-recall` | Recover relevant project knowledge and inspect its sources. |
| `allstack-handoff` | Explicitly continue an active delivery in another host. |

Skills-only setup needs no Rust project, Chronis executable, task, or delivery run. Independent shaping, planning, review, and QA use the native host's tools and permissions. Shared original methods live in [skills/](skills); Rust packages them for both hosts with capability overlays. `allstack skills` inspects the bundled interface without opening stores.

See the [native-skills guide](docs/reference/native-skills.md) for installation, standalone memory, and enrollment into durable shipping. The [Spendcheck application](examples/spendcheck) demonstrates a concrete expense-report change through these methods.

## Ecosystem underneath

| Component | Owns |
| --- | --- |
Expand All @@ -27,12 +53,11 @@ In this workflow, **ship means a verified commit pushed to a feature branch and

Workflow methods and repository policies are versioned data. Generic mechanics belong in Rust. Optional browser, research, evaluation, and hosted-service integrations follow after the core workflow is proven.

## Use the preview
## Durable delivery and recovery

Install from a reviewed checkout with Rust 1.95 or later:
For managed delivery, initialize a real project policy and Chronis:

```sh
cargo install --path . --locked
allstack --help
allstack -C /path/to/target-repository init --check --profile rust
allstack -C /path/to/target-repository init --profile rust
Expand All @@ -47,7 +72,7 @@ The [installed-bootstrap verification report](docs/reports/2026-10-24-repository

The [fresh-repository delivery report](docs/reports/2026-10-24-fresh-repository-delivery-verification.md) extends that proof through authenticated Codex → Claude Code → Codex handoffs, five executed acceptance tests, and a newly published [example PR](https://github.com/all-source-os/allstack-example/pull/1).

Starting a run needs an existing authorized feature branch, a GitHub `origin`, clean indexed inputs, and a frozen verification policy. Both coding hosts need their normal authentication and permissions. `doctor` reads setup and executable availability without opening mutable run stores; it does not authenticate hosts. Follow the [CLI guide](docs/reference/cli.md) for setup and the complete Codex → Claude Code → Codex sequence.
Managed delivery needs an authorized live feature branch, a GitHub `origin`, and an explicit verification policy. Use `start` for a clean managed journey or `adopt` to enroll completed native work with its existing accepted plan. `current` discovers the active job behind the skill interface. Both coding hosts retain normal authentication and permissions. `doctor` probes availability without authenticating them. The [CLI guide](docs/reference/cli.md) documents the underlying recovery protocol.

Select `delivery` for an accepted change or `bugfix` for evidence-led diagnosis and repair with regression coverage. Pass `start --workflow bugfix`; omitting the option retains `delivery`. Both share the same durable lifecycle and publication gates. See the [workflow catalog](docs/reference/workflow-catalog.md).

Expand All @@ -60,6 +85,7 @@ Snapshots require explicit `git add -- <path>` for new files. They reject symlin
## Documentation

- [Documentation index](docs/README.md)
- [Native skills](docs/reference/native-skills.md)
- [Cross-host workflow design](docs/plans/2026-10-24-cross-host-workflow-design.md)
- [Release acceptance scenarios](docs/reference/release-acceptance.md)
- [CLI and recovery guide](docs/reference/cli.md)
Expand All @@ -72,7 +98,7 @@ Acceptance checkboxes remain open until retained evidence establishes each claim

## Relationship to gstack

[gstack](https://github.com/garrytan/gstack) demonstrates opinionated planning, review, QA, and delivery workflows. Allstack uses that workflow shape as a reference and focuses its first release on durable cross-host continuation. Allstack's workflow text is original. Any future reuse must retain the applicable upstream and third-party notices.
[gstack](https://github.com/garrytan/gstack) demonstrates opinionated planning, review, QA, and delivery workflows. Allstack follows that specialist interaction model with original methods. AllSource, Chronis, and Prime provide durable history, ownership, and source-linked continuation underneath the native skills. Any future reuse must retain the applicable upstream and third-party notices.

## License

Expand Down
12 changes: 12 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## Design

- [2026-10-25: Spendcheck category plan](plans/2026-10-25-spendcheck-category-plan.md) — real Claude native shaping/planning output for the expense-report application change.

- [2026-10-25: Realignment with gstack's specialist workflow model](plans/2026-10-25-gstack-realignment-design.md) — product direction proposal, retained ecosystem strengths, native skills, and application-level acceptance.

- [2026-10-24: Selectable workflow catalog and bug fixes](plans/2026-10-24-workflow-catalog-design.md) — data-defined selection, retained-run compatibility, additive initialization, and authenticated bug-fix acceptance.

- [2026-10-24: Installed CLI repository bootstrap](plans/2026-10-24-repository-bootstrap-design.md) — fresh-repository setup and installed-artifact verification.
Expand All @@ -10,6 +14,12 @@

## Reference

- [Native skills and complete application verification](reports/2026-10-25-native-skills-application-verification.md) — installed interface, real Codex/Claude use, frozen expense acceptance, and durable publication evidence.

- [Native specialist skills](reference/native-skills.md) — direct Codex/Claude methods, standalone project memory, and enrollment into durable delivery.
- [Spendcheck application request](reference/native-application-request.md) — category-filtering behavior and frozen executable acceptance.
- [Source-linked expense decision](reference/native-recall-context.md) — project Prime readback and retained plan digest for incoming-host source inspection.

- [Workflow catalog and authenticated bug-fix verification](reports/2026-10-25-workflow-catalog-verification.md) — installed selection, legacy history, real host recovery, Prime repair, and retained proof identities.

- [Workflow catalog](reference/workflow-catalog.md) — selectable delivery and bug-fix methods, installation, and retained-run compatibility.
Expand All @@ -36,3 +46,5 @@ The repository is an implementation preview. Source-level contracts and fixture
- [Allstack delivery plan 750de2d1-ec0b-4327-be96-4f0e1ba5c5f5](plans/allstack-750de2d1-ec0b-4327-be96-4f0e1ba5c5f5.md)

- [Allstack delivery plan f2c4e41f-7616-4b34-aa56-4347fd1617fc](plans/allstack-f2c4e41f-7616-4b34-aa56-4347fd1617fc.md)

- [Allstack delivery plan 9dc4c81f-73ca-4b92-89a2-be3c2ca44deb](plans/allstack-9dc4c81f-73ca-4b92-89a2-be3c2ca44deb.md)
Loading
Loading