Skip to content

docs: comprehensive README update#185

Merged
fazxes merged 1 commit intomainfrom
worktree-docs+readme-update
Apr 7, 2026
Merged

docs: comprehensive README update#185
fazxes merged 1 commit intomainfrom
worktree-docs+readme-update

Conversation

@fazxes
Copy link
Copy Markdown
Member

@fazxes fazxes commented Apr 7, 2026

Summary

  • Updates README.md to accurately reflect the current repo structure after the major restructuring in session Open PR from previous session requires full review before merge #103
  • Fixes stale stats (PRs: 30+ -> 155+, modules: 34 -> 23+7), adds missing sections (role selection, security-check operator), and aligns make targets, config, CLI commands, and architecture trees with reality

Changes

  • Roles: 5 -> 6 operators (added security-check preflight description)
  • Stats table: Added daemon sessions (100+), learnings (90+), split module count into product/framework
  • Make targets: Replaced non-existent make review/overseer/strategist with actual targets (make test/dry-run/quick-test/clean)
  • CLI: Added verify-cycle command
  • Config: Updated blocked_paths (4 -> 8) and blocked_globs (3 -> 6) to match .nightshift.json.example
  • Env vars: Added descriptions and two new vars (RECURSIVE_FORCE_ROLE, RECURSIVE_PIPELINE_CHECKPOINTS)
  • New section: "How it picks what to do" explaining signal-driven role scoring
  • Recursive/ tree: Added skills/ directory, annotations for each operator and sub-agent
  • Guard rails: Added specifics (category weights, circuit breaker, truncation limits)
  • Current frontier: Updated shipped list and open queue count (69 pending)

Test plan

  • All changes are documentation-only (README.md)
  • Verify all referenced paths exist in the repo
  • Verify stats match live repo data

- Update role descriptions: 5 -> 6 operators (add security-check preflight)
- Fix merged PR count: 30+ -> 155+
- Fix module count: 34 -> 23 product + 7 framework
- Add new stats: daemon sessions (100+), documented learnings (90+)
- Update make targets to match actual Makefile (remove non-existent ones)
- Add verify-cycle CLI command to examples
- Update config to match .nightshift.json.example (8 blocked paths, 6 globs)
- Add role selection section explaining signal-driven operator scoring
- Expand Recursive/ tree with skills/, annotations, and descriptions
- Update guard rails with specifics (category weights, circuit breaker, etc.)
- Add env var descriptions and two new vars (FORCE_ROLE, CHECKPOINTS)
- Expand "What ships today" with complete self-maintaining feature list
- Update "Current frontier" with current shipped items and open queue
@fazxes fazxes merged commit 84df206 into main Apr 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant