trellis-update-spec

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

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/TECNB/MediaNexus --skill trellis-update-spec-tecnb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-update-spec
Source: https://github.com/TECNB/MediaNexus/tree/main/.agents/skills/trellis-update-spec
Command: npx skills add https://github.com/TECNB/MediaNexus --skill trellis-update-spec-tecnb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This frontmatter-driven skill helps teams prevent knowledge decay by turning learning moments into executable code-spec updates that define signatures, contracts, and test expectations.

Core Features & Use Cases

  • Captures concrete code contracts (signatures, payload fields, env keys) and coding conventions into .trellis/spec/ for future reference.
  • Documents decisions from debugging, implementation, or design discussions to guide future work and prevent regressions.
  • Use Case: after implementing a feature or fixing a bug, generate a structured spec to ensure consistency across teams and environments.

Quick Start

Use this after completing a debugging or design task to create a new code-spec entry that documents the outcome.

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 coding conventions and executable contracts after a debugging session?▼

To document coding conventions and executable contracts after a debugging session, you capture decisions, signatures, and boundary behavior into structured .trellis/spec/ files. This organizes scope, validation, and test expectations to guide future development and prevent regressions.

What is the best way to prevent knowledge decay from feature implementation and design discussions?▼

Preventing knowledge decay from feature implementation involves turning learning moments into structured code-spec updates. You record payload fields, environment keys, and contracts from design discussions into .trellis/spec/ files, ensuring consistency across teams and environments.

How do I generate code-spec files that capture signatures and test expectations?▼

You generate code-spec files by applying a spec-management process that enforces mandatory Code-Spec depth. This structures scope, signatures, contracts, validation, and tests into a target spec file, directly capturing executable contracts from your recent learning sessions.

When do I need to create a spec file for code contracts and boundary behavior?▼

You need to create a spec file for code contracts and boundary behavior immediately after completing a debugging, implementation, or design task. This captures the outcome and defines specific payload fields and environment keys for future reference.

Can I use this spec-management approach to document environment keys and payload fields for future work?▼

Yes, you can use this spec-management approach to document environment keys and payload fields for future work. It captures concrete code contracts and coding conventions from implementation sessions into .trellis/spec/ files, preventing regressions and guiding future work.

Does trellis-update-spec work without external dependencies for capturing design decisions?▼

Yes, trellis-update-spec works without external dependencies for capturing design decisions. It operates as a frontmatter-driven skill to independently organize decisions, signatures, and validation rules into target spec files during your workflow.