/find-decisions
SkillDev toolsFind all architecture decisions and choices related to a topic using sub-agents.
Available today. Use it from your connected AI after setup.
No other account needed.
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
- Identify search terms from the topic
- 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 - *.mdfiles - Look for topic in title, context, decision sections
- Extract: title, status, decision summary, date
Agent 2: Meeting Decisions (Haiku)
- Search
+Meetings/Meeting - *.mdfiles - 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 - *.mdfiles - Look for architectural/technical content about topic
- Extract relevant sections
Agent 4: Project References (Haiku)
- Search
Project - *.mdfiles - 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}}
- 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