← ClaudeAtlas

trellis-update-speclisted

Captures executable contracts and coding conventions into .trellis/spec/ documents. Use when learning something valuable from debugging, implementing, or discussion that should be preserved for future sessions.
tincopper/neeko · ★ 11 · Code & Development · score 74
Install: claude install-skill tincopper/neeko
# Update Code-Spec - Capture Executable Contracts When you learn something valuable (from debugging, implementing, or discussion), use this to update the relevant code-spec documents. **Timing**: After completing a task, fixing a bug, or discovering a new pattern --- ## Code-Spec First Rule (CRITICAL) In this project, "spec" for implementation work means **code-spec**: - Executable contracts (not principle-only text) - Concrete signatures, payload fields, env keys, and boundary behavior - Testable validation/error behavior If the change touches infra or cross-layer contracts, code-spec depth is mandatory. ### Mandatory Triggers Apply code-spec depth when the change includes any of: - New/changed command or API signature - Cross-layer request/response contract change - Database schema/migration change - Infra integration (storage, queue, cache, secrets, env wiring) ### Mandatory Output (7 Sections) For triggered tasks, include all sections below: 1. Scope / Trigger 2. Signatures (command/API/DB) 3. Contracts (request/response/env) 4. Validation & Error Matrix 5. Good/Base/Bad Cases 6. Tests Required (with assertion points) 7. Wrong vs Correct (at least one pair) --- ## When to Update Code-Specs | Trigger | Example | Target Spec | |---------|---------|-------------| | **Implemented a feature** | Added a new integration or module | Relevant spec file | | **Made a design decision** | Chose extensibility pattern over simplicity | Relevant spec + "Design Decisions" sec