trellis-update-spec

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

2|Updated Oct 15, 2023
One-click install
npx skills add https://github.com/gdm257/scoop-257 --skill trellis-update-spec-gdm257
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-update-spec
Source: https://github.com/gdm257/scoop-257/tree/main/.opencode/skills/trellis-update-spec
Command: npx skills add https://github.com/gdm257/scoop-257 --skill trellis-update-spec-gdm257

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps capture executable contracts and coding conventions observed during debugging, implementation, or discussion, and preserve them as .trellis/spec/ documents for future sessions.

Core Features & Use Cases

  • Formalize signatures, payloads, environment keys, and boundary behaviors as concrete, testable specs.
  • Preserve lessons from debugging and design decisions to maintain institutional memory for teams.
  • Provide a living reference to guide future work and prevent regressions in software artifacts.

Quick Start

Record a new code-spec update after finishing a debugging session.

Frequently Asked Questions about trellis-update-spec

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

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

To capture executable contracts after debugging, you record concrete signatures, payload fields, environment keys, and testable validation details into .trellis/spec/ documents, preserving the lessons for future sessions.

What is the best way to document code-spec decisions to prevent future regressions?

Documenting code-spec decisions involves formalizing boundary behaviors and design decisions as concrete, testable specs within .trellis/spec/ documents, creating a living reference to maintain institutional memory and prevent regressions.

When do I need to write executable contract specs for my software artifacts?

You need to write executable contract specs after completing debugging, implementation, or design discussions to formalize observed conventions and boundary behaviors into testable specifications for future reference.

Does capturing trellis spec updates require specific payload fields and environment keys?

Yes, capturing trellis spec updates requires including concrete signatures, specific payload fields, environment keys, and testable validation details to ensure the documented contracts are precise and executable.

How do I maintain institutional memory for my team's software engineering design decisions?

You maintain institutional memory by preserving lessons from debugging and design discussions as .trellis/spec/ documents, providing a living reference that guides future work and prevents regressions across sessions.

Can I use spec-writing to formalize boundary behaviors without adding testable validation details?

No, formalizing boundary behaviors through spec-writing requires including concrete signatures and testable validation details in the .trellis/spec/ documents to ensure the captured executable contracts are accurately preserved.