h-note

Solid

Records a micro-decision with rationale into the haft artifact graph — lighter than a full DecisionRecord but persisted so future sessions and conflict detection can surface it. Make sure to use this skill whenever the user says "remember that", "FYI for later", "note that we chose X", "side note", "let's record we ruled out Y", "remember we decided X", "for the record", "worth noting", "TIL", "important caveat", "save this thought" — or whenever a small choice with stated rationale belongs in project memory but does not justify the full DRR ceremony. The kernel rejects content-free notes — rationale is required. For binding choices use h-decide (manual-only). For framing problems use h-frame.

AI & Automation 1,338 stars 104 forks Updated today NOASSERTION

Install

View on GitHub

Quality Score: 89/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# h-note — Record a micro-decision You are recording a Note via the kernel. Notes are lightweight artifacts in the graph — they don't have the DRR ceremony but they do require rationale per FPF DEC-01 (no rationale-free decision capture). The Note tool lives under `haft_problem` action `select` does not write notes; the note-write surface is exposed through dedicated handlers in the MCP server. Check the actual tool name available — at present notes are written via the haft note CLI subcommand and via certain MCP integrations. ## Step 1 — Confirm intent The operator said something note-worthy. Before persisting: - Verify the note has substantive content: a fact OR a choice OR an observation with rationale - Reject: "FYI" alone, "we should remember this" with no payload - Accept: "We chose X over Y because Z" / "Observation: tests run 30s slower on M1 baseline since dependency update" ## Step 2 — Capture rationale explicitly Every Note must answer: - WHAT was decided / observed - WHY (the rationale) - WHEN (optional — kernel adds timestamp automatically; only add a domain timestamp if relevant) ## Step 3 — Persist Use the appropriate note-write tool. Currently: ``` mcp__haft__haft_problem( action="frame", problem_type="optimization", title="<short title>", signal="<the observation or choice>", acceptance="N/A — recorded as note for future recall", mode="tactical" ) ``` (Notes use the lightweight tactical-mode problem record OR a dedicated note write surfa...

Details

Author
m0n0x41d
Repository
m0n0x41d/haft
Created
6 months ago
Last Updated
today
Language
Go
License
NOASSERTION

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category