trellis-before-dev

Loads project-specific coding guidelines from .trellis/spec before writing code.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often start coding without reviewing project-specific conventions, leading to inconsistent patterns and rework. This Skill ensures coding guidelines, checklists, and shared standards from the .trellis/spec directory are read before any implementation begins. ## Core Features & Use Cases - Spec Discovery: Runs get_context.py to list packages and their spec layers so you know which guidelines apply to your target package. - Pre-Development Checklists: Reads each relevant spec index and follows its Pre-Development Checklist to locate concrete guideline files like error-handling.md or conventions.md. - Shared Guides: Always loads the shared thinking guides under .trellis/spec/guides for cross-package standards. - Use Case: Before modifying the cli/ package, run this Skill to discover applicable backend and unit-test specs, read the checklist-referenced guideline files, and then plan your implementation against those standards. ## Quick Start Before writing any code for this task, use the trellis-before-dev skill to load the relevant project coding guidelines from .trellis/spec.

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 python3 ./.trellis/scripts/get_context.py --mode packages to discover spec layers, then read the relevant .trellis/spec/<package>/<layer>/index.md files and follow their Pre-Development Checklists to the actual guideline documents.

What is the .trellis/spec directory used for?

The .trellis/spec directory stores per-package, per-layer coding guidelines such as error-handling.md, conventions.md, and mock-strategies.md, plus shared guides under .trellis/spec/guides that apply across all packages.

When should I run the pre-development checklist?

Run it before writing any code for a new task, when switching to a different package, or whenever you need to refresh project conventions. The Skill treats this step as mandatory before implementation.

Does this skill work without the .trellis directory?

No. It depends on the .trellis/scripts/get_context.py script and the .trellis/spec directory structure. Repositories without Trellis spec files have no guidelines to discover or inject.

Why is reading the spec index not enough?

The index only points to actual guideline files through its Pre-Development Checklist. You must open the referenced files like conventions.md or mock-strategies.md to learn the concrete coding standards and patterns.