trellis-update-spec

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

Updated May 2, 2026
One-click install
npx skills add https://github.com/WASIDJ/git-demo --skill trellis-update-spec-wasidj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-update-spec
Source: https://github.com/WASIDJ/git-demo/tree/main/.opencode/skills/trellis-update-spec
Command: npx skills add https://github.com/WASIDJ/git-demo --skill trellis-update-spec-wasidj

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps developers document and preserve knowledge gained during debugging, implementation, and discussions, ensuring that valuable insights are not lost over time.

Core Features & Use Cases

  • Capture Executable Contracts: Document code specifications and conventions in a structured format.
  • Update Process Guidance: Provides a systematic approach to updating code specifications based on learned insights.
  • Spec Structure Overview: Offers a clear understanding of how to organize and structure specifications for different layers and types of knowledge.
  • Interactive Mode: Assists in identifying what to update and where it belongs within the code specification.
  • Quality Checklist: Ensures that the code specifications are comprehensive, actionable, and understandable.

Quick Start

Run /trellis:update-spec to update the relevant code-spec document after learning something valuable.

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 debugging?

To document executable contracts after debugging, use a systematic approach to capture code specifications and validation rules into structured documents. This preserves valuable implementation insights by updating the relevant specification files with the newly learned knowledge.

What is the best way to preserve knowledge gained during development discussions?

The best way to preserve knowledge from development discussions is to document the gained insights as structured code specifications. By updating executable contracts, you ensure that valuable conventions and debugging context are captured for future reference.

How do I structure code specifications for different layers of knowledge?

To structure code specifications effectively, organize them into a clear spec directory overview based on layers and types of knowledge. This systematic structure ensures your contracts and validation rules are comprehensive, actionable, and understandable.

Do I need structured input to update code specifications?

Yes, updating code specifications requires structured input for defining contract specifications and validation rules. Providing organized input ensures the captured knowledge is correctly processed into the documentation and remains actionable for future reference.

Can interactive mode help identify where to update code specifications?

Yes, interactive mode assists in identifying exactly what knowledge to update and where it belongs within the code specification. It guides you through the process to ensure insights are placed correctly within the spec structure.

What should a quality checklist include for code specifications?

A quality checklist for code specifications should verify that the documented contracts and validation rules are comprehensive, actionable, and understandable. This ensures the captured knowledge remains a reliable, executable reference for future development.