Home

Queenshift Wiki

Queenshift is a governance-first bounded coding CLI.

It treats stochastic coding workers as execution surfaces inside a stricter control system, keeping review, replay, incident handling, and run artifacts explicit instead of burying them inside one opaque prompt loop.

This wiki is the contributor guide for the public repo. It focuses on the current Queenshift release surface and the best places to contribute.

Current Scope

1. swarmengine remains the shipped bounded engine.
2. queenbee remains experimental.
3. Queenshift is useful for bounded JS/TS and docs-oriented work in small clean repos.
4. Queenshift is focused on bounded JS/TS and docs-oriented work rather than broad general-use autonomous coding.

Why This Project Matters

Queenshift is building coding systems that are calmer, more inspectable, and easier to trust.

It favors bounded execution, explicit control, visible artifacts, and clear recovery when something goes wrong.

Why Contribute

People who contribute here help improve:

1. bounded JS/TS task quality
2. install and onboarding clarity
3. review, replay, incident, and verification surfaces
4. the public implementation surface behind the Queenshift architecture thesis

Start Here

1. read Current Scope
2. read Contribution Lanes
3. read Roadmap
4. read Architecture and Papers

Quick Public Links

1. GitHub repo: https://github.com/Vatsalc26/queenshift-cli
2. README: https://github.com/Vatsalc26/queenshift-cli/blob/main/README.md
3. Contributing guide: https://github.com/Vatsalc26/queenshift-cli/blob/main/CONTRIBUTING.md
4. Security policy: https://github.com/Vatsalc26/queenshift-cli/blob/main/SECURITY.md
5. Queenshift architecture note DOI: https://doi.org/10.5281/zenodo.19323465
6. Queenshift software DOI: https://doi.org/10.5281/zenodo.19374972

Related Docs

For more detail, start with:

1. the repo README for the product overview
2. docs/evidence.md for the current live and experimental status
3. docs/task-families.md for the bounded first-task shape