ryaneggz
f2b1774695
Closes #314. Adds an on-request skill that takes an artifact (file or in-context material) plus a one-line intent and produces a single self-contained HTML file optimized for the moment a human reads it once to make a decision. Writes to memory/<UTC-date>/<slug>.html (gitignored via the existing memory/[0-9]*/ rule). Encodes Thariq's HTML-over-Markdown thesis as a three-condition gate: synthesis artifact + would-be-unreadable-as-Markdown + no downstream pipeline consumer. Refuses to render source/pipeline input (PRDs, briefings, rules, skills, commit messages, log.md itself). No templates — each invocation produces bespoke HTML, picking widgets per artifact (severity table, dependency SVG, collapsible evidence). - .claude/skills/render-html/SKILL.md (new) - AGENTS.md — Skills table row - memory/README.md — recognized co-resident of log.md - CHANGELOG.md — Unreleased entry
1.5 KiB
1.5 KiB
memory/
Long-term persistent notes and session logs from harness orchestration. Tracked structured docs; daily logs gitignored.
Directory Structure
| Item | Purpose |
|---|---|
MEMORY.md |
Append-only lessons learned across sessions. See context/rules/memory.md. |
<topic>.md (top-level) |
Tracked persistent subject notes (e.g., x-campaign.md). Named in kebab-case. Evolve per usual git workflow. |
YYYY-MM-DD/log.md |
Daily session logs. One log per calendar day. Gitignored (materializes only on active work). |
YYYY-MM-DD/<slug>.html |
Bespoke HTML artifacts generated by /render-html for one-shot human review (audit synthesis, council output, lint matrix, weekly digest). Gitignored. See .claude/skills/render-html/SKILL.md. |
Conventions
- Date format:
date -u +%Y-%m-%d(UTC, ISO 8601). - One log per day: Each
YYYY-MM-DD/folder holds a singlelog.mdcovering that calendar day's session notes, decisions, and context. If a day sees multiple sessions, log entries are sequential within the same file. - Topic naming: Kebab-case, lowercase (e.g.,
x-campaign.md,agent-onboarding.md). - Gitignore: All
YYYY-MM-DD/folders and their contents are gitignored. OnlyREADME.md,MEMORY.md, and tracked<topic>.mdfiles appear in git.
Memory Improvement Protocol
See context/rules/memory.md for the full protocol governing when to add lessons to MEMORY.md, how to structure them, and append-only discipline.