NightShift

Language / 语言：English | 简体中文

NightShift is an overnight AI coding system for turning a requirement into a reviewable change, running it through an engine, and keeping a durable record of what happened. This repository is organized around the v4.2.1 product direction.

Current Status

• Active target: v4.2.1
• Kernel: implemented and verified
• Product workflow: usable today, with some MVP-shaped simplifications still visible in the docs and operator flow
• Best current proof: workflow verification report and rehearsal archive

What Works Today

• requirement splitting and proposal review in the current MVP operator loop
• approved work-order ingestion via issue import into execution-ready contracts and records
• queue admission and inspection via queue add/status/show/reprioritize
• run control via run/run --daemon/stop, plus recover for interrupted runs
• contract-scoped validation checks via validation issue
• operator visibility via logs --issue, alerts filters, and minimal report
• delivery flow via deliver * commands through pull request state progression

Quickstart Path

If you are new to NightShift, read in this order:

1. Usage entry
2. Install
3. Workflow
4. Configuration
5. Architecture entry

If you want the active spec set, continue to docs/superpowers/specs/README.md.

Docs Map

• Usage: docs/usage/README.md, docs/usage/install.md, docs/usage/configuration.md, docs/usage/workflow.md, docs/usage/deployment.md
• Product and architecture: docs/architecture/README.md, docs/architecture/product/README.md
• Product documentation design: docs/architecture/product/documentation-information-architecture.md
• Product coverage: docs/architecture/coverage/nightshift-v4.2.1-coverage-matrix.md
• Specs and design history: docs/superpowers/specs/README.md
• Verification and rehearsal evidence: docs/2026-03-28-workflow-verification-report.md, docs/rehearsals/2026-03-29-gh7-product-e2e/README.md
• Contributor note: docs/local-development.md