What problem does it solve? Repositories lose context between coding sessions, PRs, and handoffs, forcing agents and developers to rediscover prior decisions. This Skill maintains lightweight per-workstream journal files under docs/project_journal/ plus optional repo-wide PROJECT_STATE and PROJECT_TODO trackers, while refusing to bootstrap trackers into repos that have not adopted the workflow. ## Core Features & Use Cases - Adoption-gated journaling: Uses the bundled project_journal.py adoption-status helper to verify a valid tracked non-generated journal entry from the Git index before treating the workflow as adopted, so empty directories or generated indexes never trigger unwanted file creation. - Layered state updates: Writes ordinary task, PR, blocker, and handoff state into dated per-workstream journal entries, reserving PROJECT_STATE for repo-wide pulse and PROJECT_TODO for cross-workstream backlog. - Validation and discovery: Validates journal frontmatter, generates local indexes, installs optional Git hooks, and discovers recently touched repos from Codex session rollouts with bounded, fail-closed scanning. - Use Case: After finishing a multi-session PR, ask the agent to record the outcome; it updates only the relevant workstream journal entry and leaves top-level trackers untouched unless a global blocker changed. ## Quick Start Ask the agent to use the project-journal skill to check adoption status for the current repository and update the appropriate journal entry for the work just completed.
