trellis-update-spec

Capture executable contracts and coding conventions into .trellis/spec/ documents.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/21ess/graffiti --skill trellis-update-spec-21ess
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-update-spec
Source: https://github.com/21ess/graffiti/tree/main/.claude/skills/trellis-update-spec
Command: npx skills add https://github.com/21ess/graffiti --skill trellis-update-spec-21ess

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When debugging, implementing, or discussing ideas, teams often lose the concrete, testable contracts behind decisions. This skill captures those executable contracts and coding conventions into actionable code-spec documents stored under .trellis/spec/.

Core Features & Use Cases

  • Enforces code-spec discipline by codifying signatures, payload fields, env keys, and boundary behaviors.
  • Provides a structured template to document triggers, contracts, validation, and error handling for future sessions.
  • Serves as institutional memory for onboarding, audits, and cross-team collaboration.

Quick Start

After a debugging session or design discussion, run the trellis update-spec workflow to capture executable contracts and coding conventions into the relevant .trellis/spec/ documents.

Frequently Asked Questions about trellis-update-spec

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

FAQPage Schema
How do I document executable contracts and coding conventions after a debugging session?

To document executable contracts after debugging, you can capture signatures, payload fields, and boundary behaviors into structured .trellis/spec/ documents, preserving institutional memory for future cross-team alignment.

What is the best way to preserve institutional memory for onboarding and audits?

Preserving institutional memory is achieved by codifying testable contracts and coding conventions into actionable code-spec documents with explicit triggers, validation, and case guidance, ensuring audit-ready consistency.

Can I use .trellis/spec/ documents to enforce code-spec discipline across multiple teams?

Yes, you can enforce code-spec discipline across teams by applying a mandatory 7-section structure that codifies explicit triggers, signatures, contracts, and error handling within the shared .trellis/spec/ documents.

How does capturing testable contracts into code-spec documents improve future development sessions?

Capturing testable contracts into code-spec documents improves future sessions by providing structured templates that document triggers, validation, and boundary behaviors, preventing the loss of concrete decisions made during discussions.

Do I need a specific framework to codify payload fields and environment keys into spec documents?

No specific external framework is required, as the skill autonomously applies a structured template to codify payload fields, environment keys, and boundary behaviors directly into the local .trellis/spec/ directory.

Why does my team lose the concrete testable contracts behind design decisions during implementation?

Teams lose testable contracts during implementation because concrete decisions are often not codified, which this skill solves by automating the capture of executable contracts into actionable code-spec documents.