Files
our-claude-skills/official-skils-collection/notion-knowledge-capture/reference/decision-log-database.md
Andrew Yim 341d5f5a5b Initial commit: Claude Skills Factory with 8 refined custom skills
Custom Skills (ourdigital-custom-skills/):
- 00-ourdigital-visual-storytelling: Blog featured image prompt generator
- 01-ourdigital-research-publisher: Research-to-publication workflow
- 02-notion-organizer: Notion workspace management
- 03-research-to-presentation: Notion research to PPT/Figma
- 04-seo-gateway-strategist: SEO gateway page strategy planning
- 05-gateway-page-content-builder: Gateway page content generation
- 20-jamie-brand-editor: Jamie Clinic branded content GENERATION
- 21-jamie-brand-guardian: Jamie Clinic content REVIEW & evaluation

Refinements applied:
- All skills converted to SKILL.md format with YAML frontmatter
- Added version fields to all skills
- Flattened nested folder structures
- Removed packaging artifacts (.zip, .skill files)
- Reorganized file structures (scripts/, references/, etc.)
- Differentiated Jamie skills with clear roles

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 17:56:04 +09:00

2.0 KiB

Decision Log Database (ADR - Architecture Decision Records)

Purpose: Track important decisions with context and rationale.

Schema

Property Type Options Purpose
Decision title - What was decided
Date date - When decision was made
Status select Proposed, Accepted, Superseded, Deprecated Current decision status
Domain select Architecture, Product, Business, Design, Operations Decision category
Impact select High, Medium, Low Expected impact level
Deciders people - Who made the decision
Stakeholders people - Who's affected by decision
Related Decisions relation Links to other decisions Context and dependencies

Usage

Create decision records with properties:
{
  "Decision": "Use PostgreSQL for Primary Database",
  "Date": "2025-10-15",
  "Status": "Accepted",
  "Domain": "Architecture",
  "Impact": "High",
  "Deciders": [tech_lead, architect],
  "Stakeholders": [eng_team]
}

Content Template

Each decision page should include:

  • Context: Why this decision was needed
  • Decision: What was decided
  • Rationale: Why this option was chosen
  • Options Considered: Alternatives and trade-offs
  • Consequences: Expected outcomes (positive and negative)
  • Implementation: How decision will be executed

Views

Recent Decisions: Sort by Date descending Active Decisions: Filter where Status = "Accepted" By Domain: Group by Domain High Impact: Filter where Impact = "High" Pending: Filter where Status = "Proposed"

Best Practices

  1. Document immediately: Record decisions when made, while context is fresh
  2. Include alternatives: Show what was considered and why it wasn't chosen
  3. Track superseded decisions: Update status when decisions change
  4. Link related decisions: Use relations to show dependencies
  5. Review periodically: Check if old decisions are still valid