izturn/z

a vsc copilot plugin

★ 0Forks 0GitHub ↗Compare

README

z

z is a five-role AI delivery plugin built from a mixed operating model:

  • Light orchestration from startup-friendly agent teams.
  • Heavy review, QA, and recovery gates from verification-first teams.

The result is a plugin that stays small enough for founder-led execution while still enforcing independent review, diagnosis-before-fix, and reusable knowledge capture.

Team Model

z ships with five core roles:

  • @z-lead - intake, scope control, routing, handoffs.
  • @z-planner - clarification, task breakdown, acceptance criteria, risk.
  • @z-implementer - scoped code changes and local verification.
  • @z-reviewer - requirement, security, and out-of-scope checks.
  • @z-qa-debugger - testing, repro, diagnosis, and re-verification.

Operating Principle

z uses a compact six-step workflow:

  1. Intake: capture objective, constraints, owner, deadline.
  2. Clarify and plan: define scope, acceptance criteria, and task slices.
  3. Implement: ship the smallest working change.
  4. Review gate: independent compliance and quality review.
  5. QA and debug loop: reproduce, diagnose, fix, re-verify.
  6. Learn: save reusable facts, patterns, and conventions.

When To Use

Use z when you want:

  • founder-led execution without a large agent org chart;
  • clear handoffs between planning, implementation, and approval;
  • an agent team that can scale from startup work to more regulated delivery;
  • explicit checks against scope creep and low-signal AI output.

Installation

From a plugin-compatible client, point installation to this folder:

z/

Or copy the contents into a plugin source repository and install from source.

Included Files

z/
  plugin.json
  apm.yml
  README.md
  agents/
    z-lead.agent.md
    z-planner.agent.md
    z-implementer.agent.md
    z-reviewer.agent.md
    z-qa-debugger.agent.md
  skills/
    z/
      SKILL.md
      references/
        INTAKE.md
        PLAN.md
        REVIEW.md
        LEARNINGS.md

Templates Included

The skill ships with four lightweight reference templates:

Issues