Skip to content

#677 - add journal skill for local capture and delegated export#681

Open
bracyw wants to merge 3 commits into
developfrom
677-add-journal-skill
Open

#677 - add journal skill for local capture and delegated export#681
bracyw wants to merge 3 commits into
developfrom
677-add-journal-skill

Conversation

@bracyw

@bracyw bracyw commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Changes

Adds a journal skill with two clearly-separated halves. Capture drops formless notes into a gitignored .journal/ at the repo root — loose or inside category subfolders — via a thin capture.sh helper, with no git or GitHub contact. Export is an opt-in dispatcher: it reads the journal, proposes a grouping (standalone, merge a category many-to-one, or split an entry one-to-many), biases hard toward an existing docs area behind an unconditional confirm gate, delegates to the skill that owns that output (log-future-addition, to-issues, to-prd, grill-with-docs, or a plain docs write for research), then prompts whether to delete the source note.

Also adds the .journal/ gitignore line (kept distinct from .context/) and the Journal, entry, and category terms to the workflow glossary.

Notes

The journal captures and routes only — it never reimplements formatting, ticketing, or branching, and never pushes or contacts GitHub itself; every outward action is owned by the delegated flow. No new ADR: this is reversible tooling, not an architectural decision. The three commits map one-to-one to the three slice issues (#678 capture, #679 dispatcher, #680 full flow-picker).

Test Cases

  • Capture writes a loose root entry and a category-subfolder entry, both landing under a gitignored .journal/ that git does not track.
  • Capture performs no git or GitHub action.
  • Capture helper passes a shell syntax check.

Checklist

  • All commits are tagged with the ticket number
  • No linting errors / newline at end of file warnings
  • All code follows repository-configured prettier formatting
  • No merge conflicts
  • All checks passing
  • Remove any non-applicable sections of this template
  • Assign the PR to yourself
  • No package-lock.json changes (unless dependencies have changed)
  • Request reviewers & ping on Slack
  • PR is linked to the ticket (fill in the closes line below)

Closes #678
Closes #679
Closes #680


Generated by Claude Code

claude added 3 commits July 7, 2026 20:09
Local, formless, git-free capture: thin capture.sh helper drops
timestamped notes into a gitignored .journal/ at repo root, as loose
entries or inside category subfolders. Adds the .journal/ gitignore
line (distinct from .context/) and the Journal, entry, and category
terms to the workflow glossary.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R7K2o7ZV4gzQhNv7xkZwtf
Opt-in export half proving the full pipeline end-to-end against one
downstream flow: reads .journal/ layout and content, proposes grouping
(standalone / many-to-one merge / one-to-many split), biases hard to an
existing docs area with any new section surfaced for approval, gates on
an unconditional confirm showing destination and reshaped text, then
delegates a rough-idea note to log-future-addition and prompts whether
to delete the source (default keep). Journal never contacts GitHub
itself.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R7K2o7ZV4gzQhNv7xkZwtf
Extend the dispatcher's flow-picker with the remaining destinations,
reusing the existing grouping, confirm gate, and delete prompt: work
items to to-issues, a fleshed-out spec to to-prd, a decision or new term
to grill-with-docs (ADR or CONTEXT), and research to a plain docs write
into an existing section. Each delegates and never reimplements
formatting, ticketing, or branching.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R7K2o7ZV4gzQhNv7xkZwtf
@bracyw bracyw self-assigned this Jul 7, 2026
@bracyw bracyw marked this pull request as ready for review July 7, 2026 20:17
@bracyw bracyw requested a review from TheJeffreyKuo July 7, 2026 20:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants