| name | wiki-rotate-log |
| description | Rotate wiki/log.md into a timestamped archive file when it grows past ~500 lines; create a fresh log.md with an archive-pointer header |
| category | wiki |
| model | claude-sonnet-4-6 |
Wiki Rotate Log
Rotate wiki/log.md into a timestamped archive file (log-YYYY_MM_DD_HHMMSS.md) when it exceeds ~500 lines. Create a fresh log.md with an archive-pointer header. Never truncate — all content moves to the timestamped file.
The timestamp (to the second) makes every archive filename unique by construction, so repeated rotations never collide — no half-year or sequence-suffix logic needed.
Step 1: Check current log size
Read wiki/log.md. Count the total number of lines.
- If line count is under 500: report the count and warn the user: "The log has N lines — rotation is recommended at ~500. Proceed anyway? (yes / no)"
- If line count is 500 or more: proceed directly.
Step 2: Determine the archive filename
Generate a timestamp to the second using Bash: date +%Y_%m_%d_%H%M%S.
The archive filename is log-<timestamp>.md — e.g. log-2026_06_14_153012.md. Because the timestamp is unique to the second, no collision check or suffix logic is needed.
Step 3: Confirm with the user
Show the plan:
Log rotation plan:
Current: wiki/log.md (N lines)
Archive: wiki/log-2026_06_14_153012.md
New log: wiki/log.md (empty, with archive pointer)
The existing log.md will be renamed — no content is deleted.
Proceed? (yes / no)
Wait for confirmation.
Step 4: Rotate
- Rename
wiki/log.md → wiki/log-<timestamp>.md using Bash mv.
- Check for any existing archive pointers in the old log (lines starting with
> Archives:). If present, carry them forward into the new log.
- Create a new
wiki/log.md with:
# Wiki Log
Append-only record of wiki operations — ingests, queries filed back, lint passes, scaffolding. **Never edit existing entries**; only append new ones at the bottom.
Entry format (consistent prefix keeps the log greppable — `grep "^## \[" log.md | tail -5`):
[YYYY-MM-DD] |
1–3 sentences on what happened.
Operations: `scaffold`, `ingest`, `query`, `lint`, `decision`, `task`, `bug`, `requirement`, `roadmap`, `archive`, `rotate`.
> Archives: [2026_06_14_153012](log-2026_06_14_153012.md)
---
## [YYYY-MM-DD] rotate | log.md rotated — N lines archived to log-<timestamp>.md
Previous log archived to log-<timestamp>.md. Fresh log started.
Replace <timestamp> with the actual timestamp and N with the entry count. The [YYYY-MM-DD] date prefix on the rotation entry stays date-only (matching all other log entries) — only the archive filename carries the full timestamp. If there were prior archive pointers, add them to the > Archives: line separated by ·.
Step 5: Report
Confirm rotation is complete:
Done. wiki/log.md rotated:
- N lines moved to wiki/log-2026_06_14_153012.md
- New wiki/log.md created with archive pointer
CRITICAL rules
- Never delete any log content — rotation is renaming + creating a new file.
- Never edit the archived file after renaming.
- The
> Archives: header line in the new log.md must link to ALL prior archive files, not just the most recent one.
- The first entry in the new
log.md must be the rotation event itself.
