What problem does it solve?
Capture and persist user-declared project conventions so decisions are documented, consistent across the team, and automatically loaded into future AI sessions. This prevents ad-hoc rules from being lost or inconsistently applied and reduces ambiguity for new contributors.
Core Features & Use Cases
- Capture explicit conventions: Parse a single user instruction, convert it into a descriptive spec entry, and ensure the entry uses a factual tone.
- Route and detect conflicts: Determine the appropriate .superharness/spec target file, read existing content, surface conflicts with clear choices (replace, mark migration, append, cancel), and avoid silent overwrites.
- Human-in-the-loop write and trace: Present the exact markdown to write, require explicit user confirmation, commit with a standardized message, and append trace logs to the active task when applicable.
- Use Case: A developer states "From now on use zustand for state management" and the skill rewrites that into a descriptive spec entry and records it in the proper spec file after confirmation.
Quick Start
Save the user's convention "Use zustand for state management" into the appropriate .superharness/spec file and confirm the write when prompted.