@mindfoldhq/trellis 0.3.10 → 0.4.0-beta.10

package/dist/migrations/manifests/0.4.0-beta.1.json

@@ -0,0 +1,228 @@
+{
+  "version": "0.4.0-beta.1",
+  "description": "Monorepo support, unified commands, safe-file-delete, worktree submodule awareness",
+  "breaking": true,
+  "recommendMigrate": true,
+  "changelog": "**Enhancements:**\n- feat(init): auto-detect monorepo (pnpm/npm/Cargo/Go/uv workspaces + git submodules)\n- feat(init): generate per-package spec directories and config.yaml with packages list\n- feat(update): new safe-file-delete migration type — auto-removes deprecated files when content hash matches\n- feat(update): PROTECTED_PATHS prevents migrations from touching user data (.trellis/workspace, spec, tasks)\n- feat(update): config.yaml update.skip to exclude paths from safe-file-delete and template updates\n- feat(commands): merge before-backend-dev + before-frontend-dev into unified before-dev (all 9 platforms)\n- feat(commands): merge check-backend + check-frontend into unified check (all 9 platforms)\n- feat(scripts): worktree agents auto-initialize git submodules for task packages\n- feat(scripts): session-start hook supports spec_scope filtering for monorepo\n- feat(scripts): task.py and add_session.py support --package for monorepo context\n\n**Internal:**\n- refactor(scripts): Python scripts restructured — shared io/log/git modules, TypedDict type safety, god modules split into focused modules. All entry paths unchanged.\n\n**Bug Fixes:**\n- fix(update): allow rename/rename-dir migrations to target protected paths (0.2.0 compat)\n- fix(update): warn when config.yaml parse fails instead of silently disabling update.skip\n- fix(scripts): preserve git submodule status prefix character (.strip → .rstrip)",
+  "notes": "Run `trellis update` to sync new unified commands. Old before-backend-dev, before-frontend-dev, check-backend, check-frontend files will be auto-deleted if unmodified.",
+  "migrationGuide": "## Command Consolidation\n\nThe following commands have been merged:\n\n| Old (removed) | New (replacement) |\n|---------------|-------------------|\n| `before-backend-dev` | `before-dev` |\n| `before-frontend-dev` | `before-dev` |\n| `check-backend` | `check` |\n| `check-frontend` | `check` |\n\n### If you never customized these commands\n\nNo action needed. `trellis update` will:\n1. Auto-delete the old files (hash-verified, only if unmodified)\n2. Write the new unified `before-dev` and `check` commands\n\n### If you customized the old commands\n\nThe old files will NOT be deleted (hash mismatch protection). You need to:\n1. Open the new `before-dev` / `check` command file\n2. Merge your customizations from the old backend/frontend variants into the unified file\n3. Delete the old files manually once merged\n\n### Affected paths per platform\n\n- **Claude**: `.claude/commands/trellis/`\n- **Cursor**: `.cursor/commands/`\n- **iFlow**: `.iflow/commands/trellis/`\n- **OpenCode**: `.opencode/commands/trellis/`\n- **Gemini**: `.gemini/commands/trellis/`\n- **Kilo**: `.kilocode/workflows/`\n- **Codex**: `.agents/skills/`\n- **Kiro**: `.kiro/skills/`\n- **Qoder**: `.qoder/skills/`\n\n## Python Scripts Refactoring\n\nAll `.trellis/scripts/` files have been restructured internally. **No action needed** — all entry paths (`python3 .trellis/scripts/task.py`, etc.) remain unchanged. `trellis update` will sync the new scripts automatically.",
+  "aiInstructions": "When helping users migrate to v0.4.0-beta.1:\n\n1. **Check for customized old commands**: Run `git diff` or compare file hashes to see if the user modified before-backend-dev, before-frontend-dev, check-backend, or check-frontend files.\n2. **If customized**: Help merge their customizations into the new unified `before-dev` and `check` files. The new files use `python3 ./.trellis/scripts/get_context.py --mode packages` to auto-detect which specs to load, replacing the hardcoded backend/frontend split.\n3. **If not customized**: Just run `trellis update` — safe-file-delete will handle cleanup automatically.\n4. **Python scripts**: No user action needed. The refactoring preserves all entry paths. If the user has custom scripts that import from `.trellis/scripts/common/`, they may need to update imports (e.g., `from common.io import read_json` instead of inline `_read_json_file`).",
+  "migrations": [
+    {
+      "type": "safe-file-delete",
+      "from": ".claude/commands/trellis/before-backend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["7e35444de2a5779ef39944f17f566ea21d2ed7f4994246f4cfe6ebf9a11dd3e3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".claude/commands/trellis/before-frontend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["a6225f9d123dbd4a7aec822652030cae50be3f5b308297015e04d42b23a27b2a"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".claude/commands/trellis/check-backend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["4e81a28d681ea770f780df55a212fd504ce21ee49b44ba16023b74b5c243cef3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".claude/commands/trellis/check-frontend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["5e8e3b682032ba0dd6bb843dd4826fff0159f78a7084964ccb119c6cf98b3d91"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".cursor/commands/trellis-before-backend-dev.md",
+      "description": "Replaced by trellis-before-dev.md",
+      "allowed_hashes": ["7e35444de2a5779ef39944f17f566ea21d2ed7f4994246f4cfe6ebf9a11dd3e3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".cursor/commands/trellis-before-frontend-dev.md",
+      "description": "Replaced by trellis-before-dev.md",
+      "allowed_hashes": ["a6225f9d123dbd4a7aec822652030cae50be3f5b308297015e04d42b23a27b2a"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".cursor/commands/trellis-check-backend.md",
+      "description": "Replaced by trellis-check.md",
+      "allowed_hashes": ["4e81a28d681ea770f780df55a212fd504ce21ee49b44ba16023b74b5c243cef3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".cursor/commands/trellis-check-frontend.md",
+      "description": "Replaced by trellis-check.md",
+      "allowed_hashes": ["5e8e3b682032ba0dd6bb843dd4826fff0159f78a7084964ccb119c6cf98b3d91"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".iflow/commands/trellis/before-backend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["7e35444de2a5779ef39944f17f566ea21d2ed7f4994246f4cfe6ebf9a11dd3e3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".iflow/commands/trellis/before-frontend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["a6225f9d123dbd4a7aec822652030cae50be3f5b308297015e04d42b23a27b2a"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".iflow/commands/trellis/check-backend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["4e81a28d681ea770f780df55a212fd504ce21ee49b44ba16023b74b5c243cef3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".iflow/commands/trellis/check-frontend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["5e8e3b682032ba0dd6bb843dd4826fff0159f78a7084964ccb119c6cf98b3d91"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".opencode/commands/trellis/before-backend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["7e35444de2a5779ef39944f17f566ea21d2ed7f4994246f4cfe6ebf9a11dd3e3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".opencode/commands/trellis/before-frontend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["a6225f9d123dbd4a7aec822652030cae50be3f5b308297015e04d42b23a27b2a"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".opencode/commands/trellis/check-backend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["4e81a28d681ea770f780df55a212fd504ce21ee49b44ba16023b74b5c243cef3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".opencode/commands/trellis/check-frontend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["5e8e3b682032ba0dd6bb843dd4826fff0159f78a7084964ccb119c6cf98b3d91"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kilocode/workflows/before-backend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["7e35444de2a5779ef39944f17f566ea21d2ed7f4994246f4cfe6ebf9a11dd3e3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kilocode/workflows/before-frontend-dev.md",
+      "description": "Replaced by before-dev.md",
+      "allowed_hashes": ["a6225f9d123dbd4a7aec822652030cae50be3f5b308297015e04d42b23a27b2a"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kilocode/workflows/check-backend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["4e81a28d681ea770f780df55a212fd504ce21ee49b44ba16023b74b5c243cef3"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kilocode/workflows/check-frontend.md",
+      "description": "Replaced by check.md",
+      "allowed_hashes": ["5e8e3b682032ba0dd6bb843dd4826fff0159f78a7084964ccb119c6cf98b3d91"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".gemini/commands/trellis/before-backend-dev.toml",
+      "description": "Replaced by before-dev.toml",
+      "allowed_hashes": ["c384cda35b0e57de4a84d2812d59fd223c998be2aaa16a0620d7b987a08f6e33"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".gemini/commands/trellis/before-frontend-dev.toml",
+      "description": "Replaced by before-dev.toml",
+      "allowed_hashes": ["3e1ad82280f2aaabe60b93ec3e76c1017ef6282319d061e1a3de556b421317e2"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".gemini/commands/trellis/check-backend.toml",
+      "description": "Replaced by check.toml",
+      "allowed_hashes": ["8f872a2eea659abce0cbdc40ee6a197e70ffa4a4e0cbdc42ea9bb026af1cfe79"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".gemini/commands/trellis/check-frontend.toml",
+      "description": "Replaced by check.toml",
+      "allowed_hashes": ["4fb9eecf75f5efc0d9a38becc459d503261ecc5e69906cdfc489b2ef065944a6"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/before-backend-dev/SKILL.md",
+      "description": "Replaced by before-dev skill",
+      "allowed_hashes": ["4537ccee0071353beee636a052c01642a27a87b6b0a73e7bc872b2501547fa64"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/before-frontend-dev/SKILL.md",
+      "description": "Replaced by before-dev skill",
+      "allowed_hashes": ["679c1708a4d9fbad5214db299a38366581684a9383cf51a5d8ac21f890d6ba0d"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/check-backend/SKILL.md",
+      "description": "Replaced by check skill",
+      "allowed_hashes": ["9b312cfd7a07ed036769b387d84d642cd5e20f06b88e7b6a4626705fa8beb6fa"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/check-frontend/SKILL.md",
+      "description": "Replaced by check skill",
+      "allowed_hashes": ["27b75f9eea472ed104f39a65bb78ae559cfe8730c85e0742e55fd575a4a2f854"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kiro/skills/before-backend-dev/SKILL.md",
+      "description": "Replaced by before-dev skill",
+      "allowed_hashes": ["4537ccee0071353beee636a052c01642a27a87b6b0a73e7bc872b2501547fa64"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kiro/skills/before-frontend-dev/SKILL.md",
+      "description": "Replaced by before-dev skill",
+      "allowed_hashes": ["679c1708a4d9fbad5214db299a38366581684a9383cf51a5d8ac21f890d6ba0d"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kiro/skills/check-backend/SKILL.md",
+      "description": "Replaced by check skill",
+      "allowed_hashes": ["9b312cfd7a07ed036769b387d84d642cd5e20f06b88e7b6a4626705fa8beb6fa"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".kiro/skills/check-frontend/SKILL.md",
+      "description": "Replaced by check skill",
+      "allowed_hashes": ["27b75f9eea472ed104f39a65bb78ae559cfe8730c85e0742e55fd575a4a2f854"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".qoder/skills/before-backend-dev/SKILL.md",
+      "description": "Replaced by before-dev skill",
+      "allowed_hashes": ["4537ccee0071353beee636a052c01642a27a87b6b0a73e7bc872b2501547fa64"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".qoder/skills/before-frontend-dev/SKILL.md",
+      "description": "Replaced by before-dev skill",
+      "allowed_hashes": ["679c1708a4d9fbad5214db299a38366581684a9383cf51a5d8ac21f890d6ba0d"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".qoder/skills/check-backend/SKILL.md",
+      "description": "Replaced by check skill",
+      "allowed_hashes": ["9b312cfd7a07ed036769b387d84d642cd5e20f06b88e7b6a4626705fa8beb6fa"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".qoder/skills/check-frontend/SKILL.md",
+      "description": "Replaced by check skill",
+      "allowed_hashes": ["27b75f9eea472ed104f39a65bb78ae559cfe8730c85e0742e55fd575a4a2f854"]
+    }
+  ]
+}

package/dist/migrations/manifests/0.4.0-beta.10.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.10",
+  "description": "Ralph Loop field name fix, migration task assignee parsing, task lifecycle docs",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(hooks): correct SubagentStop event field names in ralph-loop (#152) — Ralph Loop was silently inert for all users because the hook read non-existent fields (subagent_type/agent_output/prompt); now reads agent_type and last_assistant_message. Check/implement/debug subagents will now actually trigger loop control.\n- fix(update): parse name from .developer when creating migration task (#153) — previously embedded the entire key=value file contents (including the initialized_at timestamp) as the task assignee, which leaked into session-start task rendering and broke the ACTIVE TASKS layout.\n\n**Documentation:**\n- docs(workflow): document task.py start/finish lifecycle and .current-task mechanism — workflow.md now documents the start/finish subcommands (previously undocumented despite being wired in argparse) and explains how .current-task feeds SessionStart hook injection. Task Development Flow expanded from 5 to 7 steps with explicit Start and Finish phases.",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync. Ralph Loop will now actually fire for check/implement/debug subagents — if you relied on the previously-silent behavior, watch for new loop activity."
+}

package/dist/migrations/manifests/0.4.0-beta.2.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.2",
+  "description": "Fix scoped npm package names in monorepo spec directory paths",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(init): strip npm scope prefix (@scope/name → name) from monorepo package directory names — prevents nested @scope/ directories in .trellis/spec/ and config.yaml",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync. If you ran `trellis init` on a monorepo with scoped packages (e.g. @scope/name), you may need to manually rename existing `.trellis/spec/@scope/name/` directories to `.trellis/spec/name/` and update the keys in `.trellis/config.yaml`."
+}

package/dist/migrations/manifests/0.4.0-beta.3.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.3",
+  "description": "Fix trellis update skipping unregistered scripts, merge v0.3.10 fixes",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(update): use getAllScripts() as single source of truth — 11 Python scripts were silently skipped by `trellis update` because they weren't registered in the manual file list\n\n**Merged from v0.3.10:**\n- fix(init): accept HTTPS URLs for --registry option (#87)\n- fix(templates): clarify record-session commit rule for AI model compatibility (#88)",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync all Python scripts that may have been missed in previous updates."
+}

package/dist/migrations/manifests/0.4.0-beta.4.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.4",
+  "description": "Git repo context for monorepo packages + improved init-context hints",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- feat(context): show git status and recent commits for independent sub-repo packages (config `git: true`)\n- feat(task): init-context now lists auto-injected defaults and available spec files to guide AI agents\n- feat(commands): add /trellis:publish-skill slash command\n- feat(marketplace): add cc-codex-spec-bootstrap skill\n\n**Bug Fixes:**\n- fix(context): use _is_true_config_value for isGitRepo consistency (case-insensitive)",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync. Projects with independent git sub-repos can now add `git: true` to package config to see their status in session context."
+}

package/dist/migrations/manifests/0.4.0-beta.5.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.5",
+  "description": "UX improvements: renamed template picker label + iFlow CLI agent fix",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- fix(init): rename \"empty templates\" to \"from scratch\" in template picker for clearer UX\n\n**Bug Fixes:**\n- fix(iflow): correct CLI agent invocation syntax in cli_adapter.py (#95)",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync."
+}

package/dist/migrations/manifests/0.4.0-beta.6.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.6",
+  "description": "CodeBuddy platform support, OpenCode plugin fix, improved skill descriptions",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- feat(platform): add CodeBuddy (Tencent) platform support with nested slash commands (.codebuddy/commands/trellis/)\n- feat(skills): improve skill descriptions across Codex, Kiro, and Qoder for better AI triggering accuracy\n\n**Bug Fixes:**\n- fix(opencode): correct plugin directory name from plugin/ to plugins/ in configurator",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync. No migration required."
+}

package/dist/migrations/manifests/0.4.0-beta.7.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.7",
+  "description": "Fix Pyright import warnings in session-start hooks",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(hooks): suppress Pyright/Pylance import warnings in session-start.py — added `type: ignore[import-not-found]` to dynamic imports from `common.*` that are resolved at runtime via sys.path",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync. No migration required."
+}

package/dist/migrations/manifests/0.4.0-beta.8.json

@@ -0,0 +1,34 @@
+{
+  "version": "0.4.0-beta.8",
+  "description": "Decouple .agents/skills/ as shared Agent Skills layer, add full .codex/ directory support",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- feat(codex): decouple .agents/skills/ as shared Agent Skills layer (agentskills.io standard)\n- feat(codex): add .codex/ directory with config, agents, skills, and SessionStart hooks\n- feat(cli): add branch context to session journal records (#108)\n\n**Bug Fixes:**\n- fix(iflow): revert incorrect --agent flag change from PR #112\n- fix(codex): correct agent TOML format (name + description + developer_instructions)\n\n**Migration:**\n- Auto-upgrade legacy Codex installs (.agents/skills/ without .codex/) on trellis update\n- safe-file-delete for .agents/skills/parallel/ and old trellis-*.toml agents",
+  "migrations": [
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/parallel/SKILL.md",
+      "description": "Moved to .codex/skills/parallel/ (Codex-specific, not shared)",
+      "allowed_hashes": ["b67b30c4e4fe00e5bc6b2f0da078e6cdfc4f082d5660b00b9ce6cfd6308d7dec"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".codex/agents/trellis-implementer.toml",
+      "description": "Renamed to implement.toml with corrected TOML format",
+      "allowed_hashes": ["e2f46f9df38485c5a0cbb562310d326a9a612dc32286bad91494a83d00c7bb3f"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".codex/agents/trellis-researcher.toml",
+      "description": "Renamed to research.toml with corrected TOML format",
+      "allowed_hashes": ["dfda47b432b653d29dbe30f07648614e6636b1120ab718b4a640a9b51da90242"]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".codex/agents/trellis-reviewer.toml",
+      "description": "Renamed to check.toml with corrected TOML format",
+      "allowed_hashes": ["b7ebff2a15c73ccd6d851122a4d202fc02adb9706942acd6601aad614e09ebc9"]
+    }
+  ],
+  "notes": "Run `trellis update` to sync. Codex hooks require `features.codex_hooks = true` in ~/.codex/config.toml."
+}

package/dist/migrations/manifests/0.4.0-beta.9.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.4.0-beta.9",
+  "description": "Copilot & Windsurf platform support, self-hosted registry, OpenCode dispatch fix, 6-phase task lifecycle",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- feat(copilot): add GitHub Copilot platform support with standalone prompt templates and hook tracking\n- feat(windsurf): add full workflow support for Windsurf IDE — rules, workflows, and AI configuration\n- feat(cli): support self-hosted GitLab/GitHub Enterprise URLs in --registry (#131)\n- feat(cli): statusLine integration for Claude Code (#127)\n- feat(cli): CodeBuddy platform support, Codex agent improvements (#128, #116)\n- refactor(task): update next_action template to 6-phase lifecycle (brainstorm→research→implement→check→update-spec→record-session)\n- refactor: migrate marketplace to standalone repo as submodule (#117)\n\n**Bug Fixes:**\n- fix(opencode): make dispatch wait for child tasks synchronously instead of background polling (#147)\n- fix(hooks): normalize .current-task path refs across platforms (#130)\n- fix(codex): resolve {{PYTHON_CMD}} placeholder in hooks.json for Windows (#132)\n- fix(cli): add_session git-add error handling and Python 3.10 version check\n- fix(cli): support self-hosted GitLab/GHE URL parsing in template-fetcher",
+  "migrations": [],
+  "notes": "Run `trellis update` to sync. New platforms: `trellis init --platform copilot` or `--platform windsurf`."
+}

package/dist/templates/claude/agents/dispatch.md

@@ -99,8 +99,7 @@ Hook will auto-inject:
 
 - finish-work.md
 - check-cross-layer.md
-- check-backend.md
-- check-frontend.md
+- check.md
 - All spec files from check.jsonl
 
 ### action: "debug"

package/dist/templates/claude/agents/implement.md

@@ -41,9 +41,8 @@ Before implementing, read:
 
 Read relevant specs based on task type:
 
-- Backend: `.trellis/spec/backend/`
-- Frontend: `.trellis/spec/frontend/`
-- Guides: `.trellis/spec/guides/`
+- Spec layers: `.trellis/spec/<package>/<layer>/`
+- Shared guides: `.trellis/spec/guides/`
 
 ### 2. Understand Requirements
 

package/dist/templates/claude/commands/trellis/before-dev.md

@@ -0,0 +1,29 @@
+Read the relevant development guidelines before starting your task.
+
+Execute these steps:
+
+1. **Discover packages and their spec layers**:
+   ```bash
+   python3 ./.trellis/scripts/get_context.py --mode packages
+   ```
+
+2. **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.)
+
+3. **Read the spec index** for each relevant module:
+   ```bash
+   cat .trellis/spec/<package>/<layer>/index.md
+   ```
+   Follow the **"Pre-Development Checklist"** section in the index.
+
+4. **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.
+
+5. **Always read shared guides**:
+   ```bash
+   cat .trellis/spec/guides/index.md
+   ```
+
+6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
+
+This step is **mandatory** before writing any code.

package/dist/templates/claude/commands/trellis/check.md

@@ -0,0 +1,25 @@
+Check if the code you just wrote follows the development guidelines.
+
+Execute these steps:
+
+1. **Identify changed files**:
+   ```bash
+   git diff --name-only HEAD
+   ```
+
+2. **Determine which spec modules apply** based on the changed file paths:
+   ```bash
+   python3 ./.trellis/scripts/get_context.py --mode packages
+   ```
+
+3. **Read the spec index** for each relevant module:
+   ```bash
+   cat .trellis/spec/<package>/<layer>/index.md
+   ```
+   Follow the **"Quality Check"** section in the index.
+
+4. **Read the specific guideline files** referenced in the Quality Check section (e.g., `quality-guidelines.md`, `conventions.md`). The index is NOT the goal — it points you to the actual guideline files. Read those files and review your code against them.
+
+5. **Run lint and typecheck** for the affected package.
+
+6. **Report any violations** and fix them if found.

package/dist/templates/claude/commands/trellis/create-command.md

@@ -101,8 +101,8 @@ Description:
 | Command Type | Prefix | Example |
 |--------------|--------|---------|
 | Session Start | `start` | `start` |
-| Pre-development | `before-` | `before-frontend-dev` |
-| Check | `check-` | `check-frontend` |
+| Pre-development | `before-` | `before-dev` |
+| Check | `check-` | `check` |
 | Record | `record-` | `record-session` |
 | Generate | `generate-` | `generate-api-doc` |
 | Update | `update-` | `update-changelog` |

package/dist/templates/claude/commands/trellis/onboard.md

@@ -126,13 +126,13 @@ AI needs the same onboarding - but compressed into seconds at session start.
 
 ---
 
-### /trellis:before-frontend-dev and /trellis:before-backend-dev - Inject Specialized Knowledge
+### /trellis:before-dev - Inject Specialized Knowledge
 
 **WHY IT EXISTS**:
 AI models have "pre-trained knowledge" - general patterns from millions of codebases. But YOUR project has specific conventions that differ from generic patterns.
 
 **WHAT IT ACTUALLY DOES**:
-1. Reads `.trellis/spec/frontend/` or `.trellis/spec/backend/`
+1. Discovers spec layers via `get_context.py --mode packages` and reads relevant guidelines
 2. Loads project-specific patterns into AI's working context:
    - Component naming conventions
    - State management patterns
@@ -140,12 +140,12 @@ AI models have "pre-trained knowledge" - general patterns from millions of codeb
    - Error handling standards
 
 **WHY THIS MATTERS**:
-- Without before-*-dev: AI writes generic code that doesn't match project style.
-- With before-*-dev: AI writes code that looks like the rest of the codebase.
+- Without before-dev: AI writes generic code that doesn't match project style.
+- With before-dev: AI writes code that looks like the rest of the codebase.
 
 ---
 
-### /trellis:check-frontend and /trellis:check-backend - Combat Context Drift
+### /trellis:check - Combat Context Drift
 
 **WHY IT EXISTS**:
 AI context window has limited capacity. As conversation progresses, guidelines injected at session start become less influential. This causes "context drift."
@@ -211,9 +211,9 @@ All the context AI built during this session will be lost when session ends. The
 
 **[1/8] /trellis:start** - AI needs project context before touching code
 **[2/8] python3 ./.trellis/scripts/task.py create "Fix bug" --slug fix-bug** - Track work for future reference
-**[3/8] /trellis:before-frontend-dev** - Inject project-specific frontend knowledge
+**[3/8] /trellis:before-dev** - Inject project-specific development guidelines
 **[4/8] Investigate and fix the bug** - Actual development work
-**[5/8] /trellis:check-frontend** - Re-verify code against guidelines
+**[5/8] /trellis:check** - Re-verify code against guidelines
 **[6/8] /trellis:finish-work** - Holistic cross-layer review
 **[7/8] Human tests and commits** - Human validates before code enters repo
 **[8/8] /trellis:record-session** - Persist memory for future sessions
@@ -228,9 +228,9 @@ All the context AI built during this session will be lost when session ends. The
 ### Example 3: Code Review Fixes
 
 **[1/6] /trellis:start** - Resume context from previous session
-**[2/6] /trellis:before-backend-dev** - Re-inject guidelines before fixes
+**[2/6] /trellis:before-dev** - Re-inject guidelines before fixes
 **[3/6] Fix each CR issue** - Address feedback with guidelines in context
-**[4/6] /trellis:check-backend** - Verify fixes didn't introduce new issues
+**[4/6] /trellis:check** - Verify fixes did not introduce new issues
 **[5/6] /trellis:finish-work** - Document lessons from CR
 **[6/6] Human commits, then /trellis:record-session** - Preserve CR lessons
 
@@ -238,16 +238,16 @@ All the context AI built during this session will be lost when session ends. The
 
 **[1/5] /trellis:start** - Clear baseline before major changes
 **[2/5] Plan phases** - Break into verifiable chunks
-**[3/5] Execute phase by phase with /check-* after each** - Incremental verification
+**[3/5] Execute phase by phase with /trellis:check after each** - Incremental verification
 **[4/5] /trellis:finish-work** - Check if new patterns should be documented
 **[5/5] Record with multiple commit hashes** - Link all commits to one feature
 
 ### Example 5: Debug Session
 
 **[1/6] /trellis:start** - See if this bug was investigated before
-**[2/6] /trellis:before-backend-dev** - Guidelines might document known gotchas
+**[2/6] /trellis:before-dev** - Guidelines might document known gotchas
 **[3/6] Investigation** - Actual debugging work
-**[4/6] /trellis:check-backend** - Verify debug changes don't break other things
+**[4/6] /trellis:check** - Verify debug changes do not break other things
 **[5/6] /trellis:finish-work** - Debug findings might need documentation
 **[6/6] Human commits, then /trellis:record-session** - Debug knowledge is valuable
 
@@ -256,7 +256,7 @@ All the context AI built during this session will be lost when session ends. The
 ## KEY RULES TO EMPHASIZE
 
 1. **AI NEVER commits** - Human tests and approves. AI prepares, human validates.
-2. **Guidelines before code** - /before-*-dev commands inject project knowledge.
+2. **Guidelines before code** - /before-dev command injects project knowledge.
 3. **Check after code** - /check-* commands catch context drift.
 4. **Record everything** - /trellis:record-session persists memory.
 

package/dist/templates/claude/commands/trellis/parallel.md

@@ -41,8 +41,7 @@ python3 ./.trellis/scripts/get_context.py
 ### Step 3: Read Project Guidelines `[AI]`
 
 ```bash
-cat .trellis/spec/frontend/index.md  # Frontend guidelines index
-cat .trellis/spec/backend/index.md   # Backend guidelines index
+python3 ./.trellis/scripts/get_context.py --mode packages  # Discover available spec layers
 cat .trellis/spec/guides/index.md    # Thinking guides
 ```
 

package/dist/templates/claude/commands/trellis/record-session.md

@@ -31,7 +31,7 @@ python3 ./.trellis/scripts/add_session.py \
   --summary "Brief summary of what was done"
 
 # Method 2: Pass detailed content via stdin
-cat << 'EOF' | python3 ./.trellis/scripts/add_session.py --title "Title" --commit "hash"
+cat << 'EOF' | python3 ./.trellis/scripts/add_session.py --stdin --title "Title" --commit "hash"
 | Feature | Description |
 |---------|-------------|
 | New API | Added user authentication endpoint |
@@ -46,6 +46,7 @@ EOF
 **Auto-completes**:
 - [OK] Appends session to journal-N.md
 - [OK] Auto-detects line count, creates new file if >2000 lines
+- [OK] Auto-detects Branch context (`--branch` override; otherwise Branch = task.json -> current git branch; missing values are omitted gracefully)
 - [OK] Updates index.md (Total Sessions +1, Last Active, line stats, history)
 - [OK] Auto-commits .trellis/workspace and .trellis/tasks changes
 
@@ -56,6 +57,6 @@ EOF
 | Command | Purpose |
 |---------|---------|
 | `python3 ./.trellis/scripts/get_context.py --mode record` | Get context for record-session |
-| `python3 ./.trellis/scripts/add_session.py --title "..." --commit "..."` | **One-click add session (recommended)** |
+| `python3 ./.trellis/scripts/add_session.py --title "..." --commit "..."` | **One-click add session (recommended, branch auto-complete)** |
 | `python3 ./.trellis/scripts/task.py archive <name>` | Archive completed task (auto-commits) |
 | `python3 ./.trellis/scripts/task.py list` | List active tasks |

package/dist/templates/claude/commands/trellis/start.md

@@ -40,10 +40,14 @@ This shows: developer identity, git status, current task (if any), active tasks.
 ### Step 3: Read Guidelines Index
 
 ```bash
-cat .trellis/spec/frontend/index.md  # Frontend guidelines
-cat .trellis/spec/backend/index.md   # Backend guidelines
-cat .trellis/spec/guides/index.md    # Thinking guides
-cat .trellis/spec/unit-test/index.md # Testing guidelines
+python3 ./.trellis/scripts/get_context.py --mode packages
+```
+
+This shows available packages and their spec layers. Read the relevant spec indexes:
+
+```bash
+cat .trellis/spec/<package>/<layer>/index.md   # Package-specific guidelines
+cat .trellis/spec/guides/index.md              # Thinking guides (always read)
 ```
 
 > **Important**: The index files are navigation — they list the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`).