Quick Start

1. Install

codex plugin marketplace add KKenny0/Tracework
codex plugin add tracework@tracework

Claude Code:

claude plugin marketplace add KKenny0/Tracework
claude plugin install tracework@tracework

2. Try a Report First

In any project with recent work, say:

write the weekly report

or:

/tracework:weekly

You can also close today first: write the daily report / /tracework:daily.

You can see a result in the conversation without configuring a vault. If the current project is still unassigned, an implicit trial reports it as local instead of pretending it is safe work. Only an explicit work scope excludes unassigned projects and explains how to fix the classification. Without raw entries, reports may use meaningful git activity as limited coverage. They do not invent intent, decisions, or verified impact.

3. Turn On Durable Storage When You Need It

When you want multi-day memory, file writes, and strict work/personal partitioning, run:

/tracework:cold-start-interview

Choose the local vault, project identity, and reporting group such as work or personal.

After upgrading from 0.2, run it once in each existing project. Unassigned projects are excluded from scoped reports rather than guessed into work output.

Common closure commands:

/tracework:daily work
/tracework:weekly work
/tracework:monthly work

Use personal for personal projects or all for a private combined view with separate group sections. Weekly has three modes: say 这周做了啥 / quick weekly for a conversation-only quick review; default write the weekly report for a Markdown brief; say weekly PPT when you need a standalone PPT-ready Markdown Deck for a department update. Without explicit framing, it serves same-department colleagues at a weekly meeting and does not invent a duration. The deck starts from why the work exists, presents this week's result or final choice and shortest rationale, and ends with next-week closure. It contains only necessary pages; zero admitted pages return an empty state. The Markdown is independently readable; PPT is its visual translation.

4. Improve the Evidence with Capture

End key work with 收工 / “wrap up” or /tracework:capture. Capture chooses lite, standard, or deep from the session signal and stores only durable facts.

If you prefer one end-of-day recovery pass, opt in with:

session_scan:
  enabled: true
  retention_days: 30

Then run /tracework:capture day [YYYY-MM-DD] [work|personal|all]. The bundled hook indexes metadata only; Capture Day partitions reporting scope before it reads transcript content.

5. Use Trust and Recovery When Needed

• /tracework:query why did we choose ...?
• /tracework:recall when resuming older work
• /tracework:roadmap for a long-range decision review

These are lower-frequency surfaces; they do not need to become daily habits.