Files
zhixing-system/.agents/skills/trellis-before-dev/SKILL.md
T
yuxuanhui bf8da90433 Add workspace index and developer-specific journals for AI sessions
- Created a main workspace index to track AI Agent work records across developers.
- Added a personal index for developer 'yuxuanhui' with current status and session history.
- Initialized the first journal file for 'yuxuanhui' to document AI development sessions.
- Introduced AGENTS.md for Trellis instructions, detailing project structure and usage guidelines.
2026-08-04 16:47:58 +08:00

1.8 KiB

name, description
name description
trellis-before-dev Discovers and injects project-specific coding guidelines from .trellis/spec/ before implementation begins. Reads spec indexes, pre-development checklists, and shared thinking guides for the target package. Use when starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards.

Read the relevant development guidelines before starting your task.

Execute these steps:

  1. Read current task artifacts:

    • prd.md for requirements and acceptance criteria
    • design.md if present for technical design
    • implement.md if present for execution order and validation plan
  2. Discover packages and their spec layers:

    python3 ./.trellis/scripts/get_context.py --mode packages
    
  3. Identify which specs apply to your task based on:

    • Which package you're modifying (e.g., cli/, docs-site/)
    • What type of work (backend, frontend, unit-test, docs, etc.)
    • Any spec/research paths referenced by the task artifacts
  4. Read the spec index for each relevant module:

    cat .trellis/spec/<package>/<layer>/index.md
    

    Follow the "Pre-Development Checklist" section in the index.

  5. Read the specific guideline files listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., error-handling.md, conventions.md, mock-strategies.md). Read those files to understand the coding standards and patterns.

  6. Always read shared guides:

    cat .trellis/spec/guides/index.md
    
  7. Understand the coding standards and patterns you need to follow, then proceed with your development plan.

This step is mandatory before writing any code.