/find-decisions

SkillDev tools

Find all architecture decisions and choices related to a topic using sub-agents.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the /find-decisions skill

About this capability

A comprehensive knowledge management system for Solutions Architects using AI

What this skill tells your AI

The instructions your AI receives, as published by davidroliverba/architectkb in .claude/skills/find-decisions/SKILL.md and read by ahel’s review.

Find all architecture decisions and choices related to a topic using sub-agents.

Usage

/find-decisions <topic>
/find-decisions Kafka
/find-decisions authentication
/find-decisions SAP integration

Instructions

Phase 1: Planning

  1. Identify search terms from the topic
  2. Plan search across multiple note types:
    • ADRs (primary source)
    • Meeting notes (decisions made sections)
    • Project files (architectural notes)
    • Pages (technical documentation)

Phase 2: Parallel Search (use sub-agents)

Launch these sub-agents in parallel using model: "haiku" for efficiency:

Agent 1: ADR Search (Haiku)

  • Search all ADR - *.md files
  • Look for topic in title, context, decision sections
  • Extract: title, status, decision summary, date

Agent 2: Meeting Decisions (Haiku)

  • Search +Meetings/Meeting - *.md files
  • Focus on "Decisions Made" and "Action Items" sections
  • Look for topic keywords
  • Extract: date, meeting name, decision text

Agent 3: Technical Documentation (Haiku)

  • Search Page - *.md files
  • Look for architectural/technical content about topic
  • Extract relevant sections

Agent 4: Project References (Haiku)

  • Search Project - *.md files
  • Find projects that involve this topic
  • Note any architectural decisions mentioned

Phase 3: Compile Results

# Decisions Related to: {{topic}}

**Search Date**: {{DATE}}
**Results Found**: {{count}}

## Architecture Decision Records

| ADR | Status | Decision | Date |
|-----|--------|----------|------|
{{ADR results}}

### ADR Details

#### {{ADR Title}}
- **Status**: {{status}}
- **Decision**: {{summary}}
- **Rationale**: {{key points}}
- **Link**: [[ADR - {{title}}]]

## Decisions from Meetings

| Date | Meeting | Decision |
|------|---------|----------|
{{meeting decisions}}

## Related Projects

{{projects involving this topic}}

## Technical Documentation

{{relevant pages with summaries}}

## Timeline

{{chronological view of decisions}}

## Gaps Identified

{{note if there are areas without documented decisions}}
  1. Highlight any conflicting decisions or areas needing clarification

Signals

GitHub stars
52
Forks
12
Last commit
Mar 2026
Advanced
Catalog kind
skill
Gateway key
find-decisions
Source
github.com/davidroliverba/architectkb