v0.2.0 — North-Star Kernel and governance skills
[0.2.0] - 2026-07-03
The governance-first release. CodeRail now leads with the North-Star Kernel and
ships as installable plugins for Claude Code and Codex.
Added
- K0 North-Star Kernel — every coding action must map to the current Outcome,
Current Bet, Invariants, or Current Slice indocs/NORTH_STAR.md. docs/NORTH_STAR.mdas the first-class, persistent direction anchor
(target ≤ 100 lines)./alignskill — intent-level check (L0–L5) before coding; produces a
North-Star Check and a task-contract candidate./drift-checkskill — detects goal drift, orphan tasks, and documentation
rot acrossNORTH_STAR,TASKS,HANDOFF, andDECISIONS.- Plugin manifests for Claude Code (
.claude-plugin/) and Codex
(.codex-plugin/), with skills underskills/. - Project template (
project-template/) —AGENTS.md,CLAUDE.md, and the
docs/set, plusTASK_GRAPH.mdandMETRICS.mdfor Standard mode. - Installer script
scripts/init_project.pywith--mode lite|standard,
copies templates without overwriting non-empty files. scripts/doctor.py— read-only governance health report.scripts/drift_check.py— static drift detection across docs.- Adoption Gate (
references/ADOPTION_GATE.md) — five criteria any new skill
or workflow must pass to enter the default set. - Four adoption tiers: Lite, Standard, Team, Enterprise (
references/MODES.md). - Validation hierarchy reference: executable harness > static acceptance >
tool-native enforcement > human review > agent self-check (soft gate only). SECURITY.md,CONTRIBUTING.md, andCODE_OF_CONDUCT.md.
Changed
- Converted the previous standalone document bundle into a plugin-compatible
package with a clearskills/+project-template/+references/layout. - Renamed the project to CodeRail (previously an internal codename).
Removed
- All research-origin terminology from runtime files. The structure test
(tests/test_structure.py) now enforces engineering-only language.
Project metadata
- Rewritten
README.mdwith explicit positioning, audience, and a comparison
section covering Superpowers, spec-kit/Kiro, and BMAD. - Public repository metadata (
package.json, plugin manifests) point to
github.com/HaipingShi/coderail.
Notes
- Self-checks remain soft gates only. Harness, CI, permissions, hooks, and
review remain the stronger validation layers (K3, K4). - No active hooks by default.
examples/contains sample hooks and
permission configs that are default-off until you review and enable them.