spec

Produce a TypeScript architectural specification from discovery findings.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kagenti/humr --skill spec-kagenti
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/kagenti/humr/tree/main/.agents/skills/spec
Command: npx skills add https://github.com/kagenti/humr --skill spec-kagenti

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams conduct thorough discovery and produce high-level architectural specifications that align with the project's TypeScript engineering approach, capturing domain concerns, bounded contexts, and service boundaries without prescribing concrete implementations.

Core Features & Use Cases

  • Conducts structured discovery interviews to elicit domain boundaries, responsibilities, and event flows.
  • Produces a domain-focused architectural specification that guides implementation while remaining implementation-agnostic.
  • Helps identify affected modules, integration points, and collaboration patterns to minimize rework and ensure architectural alignment.

Quick Start

Ask aligned discovery questions and request a high-level architectural spec for a new feature.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I create an architectural specification from domain-driven discovery findings in TypeScript?

To create an architectural specification, conduct guided discovery interviews to elicit domain boundaries and event flows, then map those bounded contexts to your TypeScript architecture. This identifies affected modules, integration points, and layer responsibilities to guide implementation without prescribing concrete code.

What is the best way to identify bounded contexts and domain events for a new feature?

Identifying bounded contexts and domain events requires structured discovery. By mapping domain concerns and event flows through guided interviews, you can clearly define service boundaries, affected modules, and integration points to ensure architectural alignment and minimize rework.

Can I use this to map domain concerns to integration points without generating implementation code?

Yes, you can map domain concerns to integration points without implementation code. This process produces an implementation-agnostic, architecture-focused specification that defines layer responsibilities and collaboration patterns, deliberately avoiding concrete code prescriptions.

How does guided discovery help define service boundaries for TypeScript architecture?

Guided discovery helps define service boundaries by using structured interviews to elicit domain responsibilities and event flows. It maps these bounded contexts directly to your TypeScript architecture, ensuring clear separation of concerns and identifying necessary integration points.

When do I need a high-level architectural specification instead of jumping straight to implementation?

You need a high-level architectural specification when capturing domain boundaries and event flows is critical before coding. It guides implementation by identifying affected modules and collaboration patterns early, minimizing rework and ensuring architectural alignment across your TypeScript project.