swain-design

Create and transition documentation artifacts through lifecycle phases.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/cristoslc/tidegate --skill swain-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swain-design
Source: https://github.com/cristoslc/tidegate/tree/main/.agents/skills/swain-design
Command: npx skills add https://github.com/cristoslc/tidegate --skill swain-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation, validation, and lifecycle management of essential documentation artifacts, ensuring consistency and traceability throughout the product development process.

Core Features & Use Cases

  • Artifact Creation: Generate Vision, Epic, Story, Spec, Spike, ADR, Persona, Runbook, Design, and Journey artifacts from templates.
  • Lifecycle Management: Transition artifacts through defined phases (e.g., Draft to Active, Testing to Implemented).
  • Validation & Auditing: Enforce ADR compliance, alignment checks, and conduct artifact audits.
  • Use Case: A product manager needs to create a new User Story for an upcoming feature. They can use this Skill to generate a STORY artifact, populate its fields, and transition it to the 'Ready' phase, ensuring it meets all defined conventions.

Quick Start

Use the swain-design skill to create a new Agent Spec artifact.

Frequently Asked Questions about swain-design

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

FAQPage Schema
How do I manage spec artifact creation and lifecycle transitions for agile documentation?

Spec artifact creation and lifecycle management is handled by generating documents from templates and transitioning them through phases like Draft to Active or Testing to Implemented. This enforces consistency and traceability across Vision, Epic, Story, Spec, and ADR artifacts.

What documentation artifacts can I generate for product lifecycle management?

Product lifecycle management documentation artifacts include Vision, Epic, Story, Spec, Spike, ADR, Persona, Runbook, Design, and Journey. Each is generated from standardized templates to ensure consistent structure and field population across the development process.

How do I create a User Story and transition it to the Ready phase?

To create a User Story, you generate a STORY artifact from its template and populate the required fields. You then transition the artifact to the Ready phase, ensuring it meets all defined conventions and passes validation checks before development.

Does this spec writing approach integrate with GitHub issues and execution tracking?

Yes, this spec writing approach integrates with GitHub issues and execution tracking. It links documentation artifacts directly to development workflows, ensuring that spec definitions are traceable and synchronized with implementation progress.

How do I enforce ADR compliance and alignment checks for documentation artifacts?

ADR compliance and alignment checks are enforced through built-in validation and auditing processes. The system validates cross-references and conducts artifact audits to ensure all Architecture Decision Records and related documents meet defined conventions.

What is the best way to manage requirements traceability across agile artifacts?

Requirements traceability across agile artifacts is best managed by defining lifecycle phase transitions and enforcing cross-reference validation. This connects Vision, Epic, and Story documents to ensure full traceability throughout the product development lifecycle.