capture-guidance

capture-guidance

One capture primitive, two routes: a correction goes to the guidance inbox for later promotion; an interaction preference goes to the profile every session reads.

Procedure

1. Classify the input.

   • A correction or ruling about the work or the process ("don't do X", "always Y here", "that pattern is banned"): route to the inbox.
   • An interaction preference (verbosity, clarifying questions per turn, ask-first versus decide-and-continue, probing depth, output style, hard red lines): route to the profile.

2. Correction route. Append one entry to ~/.agentic-sdk/<project>/guidance/inbox.edn (a vector; [] if missing; gitignored working state, consumed when incorporate-feedback promotes the entry):

   {:date "YYYY-MM-DD"
    :rule "one imperative sentence, the way a reviewer would state it"
    :context "what happened that triggered the correction"
    :applies-to :clojure | :zig | :c | :elixir | :native-edge | :persistence | :ui | :tests | :tooling | :process
    :suggested-home "check-style/references/<lang>-style.md"}
   

   :applies-to reflects the project's surfaces: the four languages; :native-edge for any C ABI, NIF, or foreign-function boundary; :persistence for the shell's store and transactions; :ui for the UI; :tests for the suite; :tooling for build, deps, or release; :process for anything cross-cutting. :suggested-home is your best guess: a reference file, a check-* or write-* skill body, a future ADR, or a lint rule when the rule is mechanically checkable. If the correction contradicts an existing rule, set :conflicts-with "<file>"; incorporate-feedback resolves it with the maintainer.

3. Preference route. Upsert the preference into ~/.agentic-sdk/<project>/guidance/profile.edn (a map; {} if missing; gitignored). One key per preference, plain values:

   {:verbosity :concise                       ; :concise | :balanced | :detailed
    :questions-per-turn 2
    :default-behavior :decide-and-continue    ; :ask-first | :decide-and-continue | :decide-silently
    :probing-depth :standard                  ; :light | :standard | :deep
    :output-style :structured                 ; :structured | :prose | :mix
    :red-lines ["never advance main autonomously"]}