isa

Generate a verifiable Ideal State Artifact with pass/fail criteria and YAML frontmatter.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Z5Jonathan-maker/ai-coding-os --skill isa-z5jonathan-maker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: isa
Source: https://github.com/Z5Jonathan-maker/ai-coding-os/tree/main/claude/skills/isa
Command: npx skills add https://github.com/Z5Jonathan-maker/ai-coding-os --skill isa-z5jonathan-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents vague or shifting outcomes by forcing a task’s ideal end-state to be defined up front as measurable, checkable criteria.

Core Features & Use Cases

  • Ideal State Criteria (ISCs): Produces discrete, verifiable “definition of done” items that can be independently checked.
  • Mapped verification: Requires each ISC to include a test command or a concrete verification procedure, so completion is evidence-based.
  • Scope guardrails: Includes anti-goals, out-of-scope, and constraints to reduce scope creep and keep execution aligned.

Use cases: redesigns, multi-step refactors, audits/research deliverables, content commissions, and work that needs a ship-gate.

Quick Start

Ask the assistant to run the isa workflow for the task “Implement a new landing page with a pricing section” and write the resulting ISA to .ai/ISA-<slug>.md.

Frequently Asked Questions about isa

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

FAQPage Schema
How do I define a verifiable definition of done for a multi-step redesign task?▼

To define a verifiable definition of done for a redesign task, you generate an Ideal State Artifact containing 3-10 atomic Ideal State Criteria with explicit pass/fail signals. This ensures completion is evidence-based rather than subjective.

What is an Ideal State Artifact and when do I need one for task planning?▼

An Ideal State Artifact (ISA) is a structured document that defines a task's measurable end-state with discrete, checkable criteria. You need an ISA for task planning when executing multi-step refactors, audits, or redesigns that lack a crisp done-state.

How do I prevent scope creep during a complex content commission or research deliverable?▼

Prevent scope creep during a content commission or research deliverable by defining anti-goals, out-of-scope items, and constraints alongside your Ideal State Criteria. These scope guardrails keep execution aligned with the original ideal state artifact.

Can I use mapped verification and ship gates for audit criteria in research deliverables?▼

Yes, you can use mapped verification for audit criteria in research deliverables by assigning each criterion a concrete test command or verification procedure. This creates an evidence-based ship gate that confirms all atomic criteria pass before final delivery.

Does the Ideal State Artifact workflow support YAML frontmatter for task planning?▼

Yes, the Ideal State Artifact workflow requires YAML frontmatter to define the ISA structure and persists the result to a .ai/ISA-<slug>.md file. This ensures the task planning definition of done is version-controlled and accessible.

What are the limitations of using atomic Ideal State Criteria for a small refactor?▼

Using atomic Ideal State Criteria for a small refactor may introduce unnecessary overhead, as the workflow requires generating 3-10 discrete criteria with explicit verification procedures. This structured ship-gate approach is designed for multi-step work lacking a crisp done-state.