agentsclimarketplace

Decision recording

Skill HyunKN/harness-kit/skills/decision-recording

Harness Kit is a reusable Codex workflow layer for repositories that want a clean operating system around implementation work.

Install
npx -y skills add HyunKN/harness-kit --skill decision-recording

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when a repository should capture a high-impact engineering decision in `docs/records` instead of leaving the reasoning in chat history. Trigger for architecture changes, dependency choices, operating-rule changes, or decisions that would be expensive to reverse later.

SKILL.md

1.5 KB, 233 tokens by cl100k_base, as published. Nobody here has run it

Decision Recording

Capture the why behind non-trivial engineering choices so later work does not depend on memory.

This skill is for durable decision rationale, not implementation walkthroughs.

Default flow

  1. Confirm the decision is real, accepted, and worth keeping.
  2. Record the context that forced the decision.
  3. List the main options that were considered.
  4. Write the chosen direction and its consequences.
  5. Link evidence such as issue docs, incidents, experiments, or benchmarks.
  6. Prefer docs/records/ for the note and update the records index when the decision matters beyond one task.

Good fit

  • selecting or removing a dependency
  • changing architecture boundaries
  • introducing a strong guardrail or operating rule
  • choosing a workflow that other contributors must follow

Avoid for

  • obvious implementation details
  • temporary experiments that are not yet accepted
  • one-off edits with no lasting downstream effect

Resources

  • See references/decision-checklist.md for the minimum record contents.
  • Use technical-learning-note for how the implementation works and issue-driven-workflow for task-local execution state.

What ships with it: 2 files

434 B alongside SKILL.md

agents/

references/

Keep looking

Skills are one crate of 327,069. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.