Decision Record

1{
2  "name": "Create Decision Record",
3  "skills": ["knowledge-capture"],
4  "query": "Document our decision to use PostgreSQL instead of MongoDB for our new service",
5  "context": "User has just explained the decision with rationale, options considered, and trade-offs",
6  "expected_behavior": [
7    "Recognizes this as a decision record (architectural decision) from conversation context",
8    "Uses Decision structure: Context → Decision → Rationale → Options Considered (with Pros/Cons) → Consequences → Implementation",
9    "Extracts from context: decision made, options considered (PostgreSQL vs MongoDB), rationale, trade-offs",
10    "Creates document with proper structure including Date, Status (Accepted), and Deciders",
11    "Includes both positive and negative consequences (trade-offs) in Consequences section",
12    "Uses Notion:notion-search to check if decision log database exists",
13    "If database exists, asks whether to add there or create standalone page",
14    "If creating in database, fetches schema using Notion:notion-fetch and sets properties: Decision title, Date, Status, Domain (Architecture), Deciders, Impact",
15    "Uses Notion:notion-create-pages with parent: { data_source_id } for database or { page_id } for parent page",
16    "Applies proper Notion markdown formatting with sections",
17    "Suggests linking from architecture docs or project pages"
18  ],
19  "success_criteria": [
20    "Document follows Decision structure from SKILL.md content types",
21    "All key sections present: Context, Decision, Rationale, Options Considered (with Pros/Cons for each), Consequences, Implementation",
22    "Decision is clearly stated (PostgreSQL chosen over MongoDB)",
23    "Options that were considered are documented with pros/cons structure",
24    "Rationale explains why PostgreSQL was chosen based on conversation context",
25    "Consequences include both positive (benefits) and negative (trade-offs)",
26    "If in database, properties are set correctly from schema (Decision, Date, Status: Accepted, Domain: Architecture, Impact)",
27    "Document is dated and has status 'Accepted'",
28    "Uses correct tool names (Notion:notion-search, Notion:notion-fetch, Notion:notion-create-pages)"
29  ]
30}
31