ianphil

AI Notes — Consolidate

No description provided

ianphil 0 Updated 3mo ago
GitHub

Install

npx skillscat add ianphil/my-skills/ainotes

Install via the SkillsCat registry.

SKILL.md

AI Notes — Consolidate

Consolidate raw session observations from .ainotes/log.md into a curated .ainotes/summary.md.

Workflow

  1. Check if .ainotes/ directory exists in the repo root. If not, create it with empty summary.md and log.md.
  2. Read .ainotes/log.md — these are raw observations appended by the commit skill.
  3. Read .ainotes/summary.md — this is the current curated summary.
  4. Consolidate log entries into summary:
    • Merge new observations into the appropriate section
    • Deduplicate — if a fact is already in summary, skip it
    • Merge related observations into single concise entries
    • Prune stale info that contradicts newer observations
    • Keep summary under ~200 lines (hard limit)
  5. Write updated summary.md
  6. Truncate log.md — keep only the last 10 entries as a buffer, remove everything else.

summary.md Format

Use structured sections. Only include sections that have content:

# AI Notes — <project name>

## Architecture
- <observation>

## Gotchas
- <observation>

## Workflows
- <observation>

## Testing
- <observation>

## Dependencies
- <observation>

## Conventions
- <observation>

Rules

  • Every bullet must be a terse one-liner — no paragraphs
  • Prefer specifics over generalities (file paths, command names, exact behavior)
  • If summary exceeds ~200 lines, aggressively prune least-useful entries
  • Never duplicate information already in README.md or AGENTS.md
  • When merging contradictory observations, keep the newer one