bm-scribe:create-feature

create-feature

Creates a project-knowledge feature note at <PROJECT>/features/<slug>/main per the v0.7.0 canonical layout and the three-step pattern.

Step 1 — Gather inputs

Ask the user for:

• <slug> (a kebab-case feature name) — required, comes from the invocation argument if provided.
• title — one-line human title.
• description — user-facing description.
• recent_changes — list of release-tagged change pointers (e.g. v0.6.0 — added X).

If BM_SCRIBE_PROJECT is unset, ask the user which BM project to write to and remember the answer for the rest of this session.

Step 2 — Resolve project + permalink

• <PROJECT> = $BM_SCRIBE_PROJECT (or the answer from Step 1).
• Canonical permalink = <PROJECT>/features/<slug>/main (substitute <PROJECT> and <slug>).
• Directory portion (passed to write_note) = canonical permalink with the trailing /main stripped.

Step 3 — Issue the three-step BM call sequence

Follow ../../docs/three-step-pattern.md. Concretely:

# Step 3a — create. BM ignores metadata.permalink.
basic-memory:write_note(
  title=<title>,
  directory="<PROJECT>/features/<slug>",
  note_type="feature",
  content=<rendered body>,
  metadata={
    permalink: "<PROJECT>/features/<slug>/main",
  }
)
# Capture the returned permalink — call it AUTO_PERMALINK.

# Step 3b — relocate.
basic-memory:move_note(
  identifier=AUTO_PERMALINK,
  destination_path="<PROJECT>/features/<slug>/main.md"
)

# Step 3c — read the moved note to capture the YAML permalink line verbatim.
basic-memory:read_note(identifier="<PROJECT>/features/<slug>/main")
# Extract the current `permalink: …` line from the frontmatter; call it CURRENT_PERMALINK_LINE.

# Step 3d — rewrite the YAML permalink line.
basic-memory:edit_note(
  identifier="<PROJECT>/features/<slug>/main",
  operation="find_replace",
  find_text=CURRENT_PERMALINK_LINE,
  replace_text="permalink: <PROJECT>/features/<slug>/main"
)

Step 4 — Verify

• basic-memory:read_note(identifier="<PROJECT>/features/<slug>/main") returns the note.
• The YAML permalink: field in the returned frontmatter equals <PROJECT>/features/<slug>/main exactly.
• Report success to the user with the canonical permalink in a paste-ready form: [[<PROJECT>/features/<slug>/main]].