h-note

Persists lightweight non-binding facts and observations into Haft project memory.

1.4k|102|Updated Dec 10, 2025
One-click install
npx skills add https://github.com/m0n0x41d/haft --skill h-note
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: h-note
Source: https://github.com/m0n0x41d/haft/tree/main/internal/cli/skill/h-note
Command: npx skills add https://github.com/m0n0x41d/haft --skill h-note

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Small facts, caveats, and observations raised during AI-assisted engineering sessions are easily lost between conversations. This Skill saves them as addressable, non-binding notes in Haft project memory so later work can reference them without turning every remark into a formal decision record.

Core Features & Use Cases

  • Explicit-save gating: Persists a note only when the operator asks ("remember this", "note for later") or names a concrete receiving use, avoiding memory pollution from ordinary reasoning.
  • Entity resolution: Optionally resolves and hydrates the current EntityOfConcern via haft_query memory mode before saving, so notes attach to the correct project concern.
  • Typed persistence: Saves through the haft_note MCP surface with title, atomic observations, rationale, anchors, expiry, and task context, returning a note ID and typed record reference.
  • Use Case: During a debugging session the operator says "remember that the staging API rate limit is 50 req/min". The Skill saves this as a non-binding note with source context, retrievable in later sessions.

Quick Start

Ask the agent to remember a specific fact, for example: "Remember that the payment webhook retries three times before failing."

Frequently Asked Questions about h-note

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save a note in Haft project memory?

Explicitly ask the agent to remember a fact, such as "remember this" or "note for later". The Skill persists it through the haft_note MCP tool with a title, atomic observations, optional rationale, anchors, and task context, returning a note ID.

What is the difference between a Haft note and a decision record?

A note is a non-binding fact or observation, while a decision binds a choice and must go through the h-decide skill. Notes never represent approvals, evidence verdicts, ProblemCards, or WorkPlans.

When should I not use h-note to persist information?

Do not use it for ordinary conversational reasoning, binding choices, unresolved problem framing, or evidence verdicts. Those cases route to h-decide or h-frame instead, and casual asides should not be auto-persisted.

Does h-note require an EntityOfConcern to save a note?

No. If the exact entity identity is known it is resolved via haft_query memory mode and attached, but missing setup or explicit abstention is non-blocking and the note saves without invented concern fields.

Can a saved Haft note expire automatically?

Yes. Time-bounded facts can include a valid_until field with an RFC3339 expiry timestamp, marking when the note's content goes stale in project memory.