trackbed:docs:solution-note

Record a solved problem in docs/solutions/ after a fix, migration, or lesson; --refresh audits existing notes against the code.

/trackbed:docs:solution-note [problem, lesson, or context] | --refresh [solution-note-path|--all] [--apply]

• Invocation: User
• Hosts: Claude Code, Codex ($trackbed:docs:solution-note in Codex)
• Category: Documentation & Writing
• Source: trackbed/skills/docs:solution-note/SKILL.md

Description

Create a reusable solved-problem note in docs/solutions/ after a bug fix, migration, repeated workflow, tricky refactor, or implementation lesson: failed approaches, final approach, code references, verification, and reuse cautions. With --refresh, audit existing notes against the code as keep, update, consolidate, or delete, confirming deletions and consolidations. Not for ADRs (trackbed:docs:adr), domain vocabulary (trackbed:docs:ubiquitous-language), feature specs, or rejected enhancements.

Related

• Refers to: trackbed:code:encode-constraint, trackbed:docs:adr, trackbed:docs:feature-spec, trackbed:docs:track-rejected-enhancements, trackbed:docs:ubiquitous-language
• Referred to by: trackbed:docs:sync-release