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.