archetype-scanner

Scans domain requirements against archetype mappers in parallel and merges results into a fit report.

Updated Nov 19, 2020
One-click install
npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill archetype-scanner-kwojtasinski-repo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archetype-scanner
Source: https://github.com/kwojtasinski-repo/ECommerceApp/tree/main/.github/skills/archetype-scanner
Command: npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill archetype-scanner-kwojtasinski-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting domain modeling, it is hard to know which known archetypes (accounting, pricing, knowledge, party, etc.) apply to a new set of requirements. This Skill removes the guesswork by systematically testing every registered archetype against your requirements and consolidating the findings into one report. ## Core Features & Use Cases - Parallel archetype scanning: Launches one agent per live archetype mapper simultaneously, each running its own fit test and full mapping when applicable. - Reference-only archetype tracking: Records archetypes without live mappers as knowledge references instead of failing the scan, so incomplete libraries never block analysis. - Merged summary report: Produces a fit/ directory with per-archetype results and a summary.md covering matched archetypes, domain concept distribution, overlaps, gaps, and rejection reasons. - Use Case: Given requirements for an e-commerce checkout flow, run the scanner to discover that pricing and accounting archetypes fit, while order and payment exist only as reference material — then decide which mapper to dive deeper into. ## Quick Start Ask the assistant to run the archetype scanner on your domain requirements, for example: scan these requirements for a subscription billing domain against all known archetypes.

Frequently Asked Questions about archetype-scanner

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

FAQPage Schema
How do I check which domain archetypes fit my requirements?

Run the archetype scanner with your domain requirements as input. It launches one agent per live archetype mapper in parallel, each performing a fit test and full mapping when applicable, then merges everything into a summary report.

What happens when an archetype mapper is missing during a scan?

Missing mappers are treated as known gaps, not failures. Reference-only archetypes are recorded in the summary as knowledge references with their source document, and the scan continues with all available live mappers.

When should I use the archetype scanner instead of a single archetype mapper?

Use the scanner during early domain modeling when you do not yet know which archetypes apply. If you already know which single archetype fits, invoke that archetype mapper directly instead of running a full scan.

What output does the archetype scan produce?

The scan creates a fit/ directory containing one markdown file per matched archetype, reference notes for reference-only archetypes, and a summary.md with a fit table, domain concept distribution, overlaps, gaps, and rejection reasons.

What if no archetype fits my domain requirements?

The summary is still generated even when all live archetypes return no-fit. It focuses on the gaps section, listing uncovered domain concepts and suggesting next steps such as modeling directly or defining a custom archetype.