ki-decision-records

Automate creation, management, and audit of Decision Records in Nygard five-section format.

Updated May 29, 2026
One-click install
npx skills add https://github.com/knowledgeislands/ki-agentic-harness --skill ki-decision-records
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ki-decision-records
Source: https://github.com/knowledgeislands/ki-agentic-harness/tree/main/skills/ki-decision-records
Command: npx skills add https://github.com/knowledgeislands/ki-agentic-harness --skill ki-decision-records

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The ki-decision-records skill solves the challenge of managing and organizing significant decisions across Knowledge Islands repos, providing a standardized format to enhance traceability and consistency in decision-making.

Core Features & Use Cases

  • Standardized Format: Enforces the Nygard five-section format with a specific prefix for each decision type, ensuring clarity and uniformity.
  • Prefix Table: Maps decision types to their respective prefixes for easy identification.
  • Naming Convention: Specifies a structured naming convention for Decision Records (DRs), facilitating organization and identification.
  • Living Records: Ensures that DRs are updated in place rather than superseded, preserving the historical context.
  • Audit and Conform: Offers tools to audit and conform DRs to the established standards.

Quick Start

Run the 'init' command to establish the Decision Records directory and index. Then, create a new Decision Record using the 'new' command, providing the scope and title.

Frequently Asked Questions about ki-decision-records

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

FAQPage Schema
How do I create decision records using a standardized format?

To create decision records using a standardized format, run the 'init' command to set up the directory and index, then use the 'new' command with a scope and title to generate records enforcing the Nygard five-section format.

What is the Nygard five-section format for decision traceability?

The Nygard five-section format is a standardized structure for decision records that ensures clarity and uniformity, mapping specific prefixes to decision types to enhance traceability across governance, architecture, and strategy contexts.

How do I manage architectural decision records so they preserve historical context?

Manage architectural decision records by maintaining them as living records updated in place rather than superseded, preserving historical context while using structured naming conventions and an audit tool to enforce conformity.

Can I audit existing decision records to conform to a standardized naming convention?

Yes, you can audit existing decision records to conform to standards by using the built-in audit tools that check records against the established prefix table and structured naming conventions for easy identification.

When do I need to use a standardized decision management process for my repositories?

You need to use a standardized decision management process when organizing significant decisions across Knowledge Islands repos to provide consistency, traceability, and structured governance for architecture and strategy decisions.

Does this decision management approach require any external dependencies to work?

No, this decision management approach requires no external dependencies to work; it operates independently using internal scripts and references to automate creation, management, and audit of records.