skills.rest
julianobarbosa
julianobarbosaCOMMUNITY
Explore all skills by this author →
Website𝕏@julianobarbosaGitHub

ISA

Generate and manage Ideal State Artifacts with testable criteria and verification evidence.

Updated Aug 27, 2026
Search Tags:#project onboarding#workspace memory#testable criteria#spec scaffolding#ideal state artifact#tier completeness#deterministic merge
One-click install
npx skills add https://github.com/julianobarbosa/.claude --skill isa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ISA
Source: https://github.com/julianobarbosa/.claude/tree/main/skills/ISA
Command: npx skills add https://github.com/julianobarbosa/.claude --skill isa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The ISA skill turns fuzzy or evolving intentions into a hard-to-vary Ideal State artifact with explicit success conditions, tests, and evidence so work can be scaffolded, audited, and merged without drift.

Core Features & Use Cases

  • Scaffold an ISA from a prompt: Generate a new, tiered ideal-state document with a locked section order (Problem through Verification) for projects, tasks, and work sessions.
  • Interview to fill gaps: Ask targeted questions to deepen thin or missing ISA sections until the tier completeness gate is satisfied.
  • Check completeness: Score an existing ISA against the tier requirements and report gaps that block completion.
  • Reconcile ephemeral feature edits: Deterministically merge an ephemeral feature slice back into the master ISA keyed on stable ISC IDs.
  • Seed from an existing repository: Bootstrap a draft project ISA from README and repo structure so teams can adopt the ISA system without inventing fiction.

Quick Start

Run the ISA skill to scaffold and test-drive an Ideal State spec by saying: "Scaffold an ISA for this project prompt at tier E3 and then check completeness."

Frequently Asked Questions about ISA

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

FAQPage Schema
How do I turn project goals into a testable spec?▼

You turn fuzzy project goals into a testable spec by generating an Ideal State Artifact (ISA) with explicit success conditions, verification evidence, and a locked twelve-section structure to prevent project drift.

How do I scaffold an ideal state document from a project prompt?▼

Scaffold an ideal state document by running the ISA skill against your project prompt to generate a tiered document with a locked section order spanning from Problem through Verification, ensuring immediate structural compliance.

Can I bootstrap a project spec from an existing repository?▼

Yes, you can bootstrap a draft project ISA directly from an existing repository by reading the README and repo structure, allowing teams to adopt the ISA system without inventing fictional context.

How do I deterministically merge ephemeral feature edits into a master spec?▼

Deterministically merge ephemeral feature slices back into a master ISA by keying on stable ISC IDs, enforcing canonical append and merge workflows that produce auditable Decisions, Changelog, and Verification records.

How do I check spec completeness and identify missing sections?▼

Check spec completeness by scoring an existing ISA against tier requirements to report gaps that block completion, using targeted interviewing to deepen thin or missing sections until the tier completeness gate is satisfied.

Related Skills

Explore More Product & Management Skills→
tneztnez

bootstrap

Initialize the .docent directory structure and configuration for new projects.

Community
Basic
xenotaurxenotaur
1

lrh-land

Automate end-to-end pull request landing with review, fix, and merge workflows.

Community
Advanced
davduncdavdunc

ISA

Scaffold, interview, audit, reconcile, or seed Ideal State Artifacts with verification evidence.

Community
Advanced
jcwleojcwleo
10

interview

Guide requirements discovery through structured Socratic interviews with approval gates.

Community
Advanced