Log

Spawn log-writer subagent to explorer memories and recent code changes, write concise log entries to ./docs/logs/. Focus on key events, changes, impacts, and decisions. Run /hi-project-organization to organize outputs.

Arguments

• Default: summarize last session (claude-mem + recent diffs)
• [topic] - focus log on a specific area (e.g. auth, ci, release)
• --since <ref> - only changes after git ref/sha/date (default: last 24h)
• --scope <dir> - limit exploration to a directory (e.g. src/api/)

Workflow

1. Discover

Pull context from claude-mem (recent observations) and git diff/log. Use hi-explorer if scope is ambiguous. Honor --since / --scope filters.

2. Filter

Keep entries that change behavior, fix risk, or capture a decision. Drop noise: trivial formatting, regenerate-only commits, no-op refactors.

3. Write

Spawn log-writer subagent per references/log-writer-contract.md. One file per logical event. Filename: YYYY-MM-DD-<slug>.md.

4. Organize

Run /hi-project-organization to index logs under ./docs/logs/. Ensure cross-links to plans (./plans/) and journal entries.

Non-Negotiable Rules

• Do NOT log empty sessions. If no material change -> abort with notice.
• Always include Impact section in every entry.
• Tie each entry to concrete references: path/to/file.ts:LINE or commit:sha.
• One event = one file. No monolithic daily dumps.
• Preserve decision rationale, not just the outcome.

Output Format

# <Title> — YYYY-MM-DD
## Context
What triggered this work (bug, request, plan link).
## Change
What changed, with `file:line` references.
## Impact
Who/what is affected. Risk level (low/med/high).
## Decision
Why this approach. Alternatives considered.
## References
- plan: ./plans/<id>/plan.md
- commit: <sha>
- memory: <obs-id>

References

• Subagent contract: references/log-writer-contract.md
• Output: ./docs/logs/
• Indexer: /hi-project-organization