trellis-before-dev

Loads project coding guidelines from .trellis spec indexes before implementation begins.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/gyc-12/Archipelago --skill trellis-before-dev-gyc-12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-before-dev
Source: https://github.com/gyc-12/Archipelago/tree/main/.cursor/skills/trellis-before-dev
Command: npx skills add https://github.com/gyc-12/Archipelago --skill trellis-before-dev-gyc-12

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often start coding without reviewing project-specific conventions, leading to inconsistent code that violates established standards. This Skill ensures coding guidelines, checklists, and shared thinking guides are read before any implementation work begins. ## Core Features & Use Cases - Spec Discovery: Runs a Python script to enumerate packages and their spec layers in the .trellis directory. - Checklist-Driven Reading: Follows Pre-Development Checklists in spec index files to locate relevant guideline documents like error-handling.md and conventions.md. - Shared Guide Loading: Always reads the shared guides index to capture cross-package standards. - Use Case: Before modifying the cli/ package, run this Skill to discover which backend and unit-test specs apply, read the listed guideline files, and then write code that conforms to project conventions. ## Quick Start Before writing any code for this task, load the relevant Trellis development guidelines for the package I am about to modify.

Frequently Asked Questions about trellis-before-dev

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

FAQPage Schema
How do I load project coding guidelines before writing code?

Run the get_context.py script with --mode packages to discover spec layers, then read the index.md files for relevant packages and follow their Pre-Development Checklists to the actual guideline documents.

What is a pre-development checklist in a spec index?

It is a section in each .trellis spec index.md that lists the specific guideline files, such as error-handling.md or conventions.md, that must be read before implementing changes in that package or layer.

When should I refresh project conventions during a task?

Refresh conventions when starting a new coding task, switching to a different package, or changing work type such as moving from backend to frontend, since each package and layer has its own spec index.

Does this workflow require any external Python packages?

No external dependencies are required. The workflow uses the standard python3 interpreter to run .trellis/scripts/get_context.py and the cat command to read Markdown index and guideline files.

What happens if I skip reading the spec guidelines?

Skipping the guidelines risks producing code that violates project conventions for error handling, mocking, and structure. The Skill marks this reading step as mandatory before writing any code.