Skip to content
TakoAPI
Back to skills

contract-diagram

by nonlinear

PDF & Documents
376Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Diagram as contract for agreed-upon AI development.

Description

What This Skill Does

A contract-based workflow system for AI-assisted development. Teams embed a Mermaid diagram in a markdown file and use status badges to track each component through design approval, implementation, and sign-off. The diagram acts as the single source of truth for what was agreed, what is built, and what is blocked.

Keeps AI development scope and status visible in the same file as the spec, avoiding drift between what was agreed and what gets built.

When to Use It

  • Tracking stakeholder approval on AI-generated feature designs before coding starts
  • Flagging implementation blockers that require a human decision or permission
  • Auditing which parts of a feature were decided by the AI vs explicitly approved
  • Reviewing the live state of a feature contract in a local browser during development
  • Documenting developer decisions made mid-implementation with numbered notes

Example Workflow

INPUT

User asks: "lets diagram epic-notes/webhook-contract.md"

AGENT
  1. 1

    Check that the file at the given path contains exactly one Mermaid diagram

  2. 2

    Start a localhost server on port 8080 from the skill engine directory

  3. 3

    Open the browser pointing to the contract file via query parameter

  4. 4

    Enable hot reload to reflect badge status changes every 2 seconds

OUTPUT

A live browser view of the contract diagram with current phase and status badges, updating automatically as the file changes

Installation

clawhub install nonlinear/contract-diagram

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links