@blxzer/cursor-trellis 0.2.9 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +94 -0
- package/README.md +85 -19
- package/README.zh-CN.md +60 -21
- package/bin/smart-search.js +1 -1
- package/dist/cli/index.d.ts.map +1 -1
- package/dist/cli/index.js +46 -18
- package/dist/cli/index.js.map +1 -1
- package/dist/commands/capability-smoke.d.ts +24 -0
- package/dist/commands/capability-smoke.d.ts.map +1 -0
- package/dist/commands/capability-smoke.js +83 -0
- package/dist/commands/capability-smoke.js.map +1 -0
- package/dist/commands/channel/agent-loader.d.ts +1 -1
- package/dist/commands/channel/agent-loader.js +4 -4
- package/dist/commands/channel/agent-loader.js.map +1 -1
- package/dist/commands/channel/guard.d.ts +2 -2
- package/dist/commands/channel/guard.js +3 -3
- package/dist/commands/channel/guard.js.map +1 -1
- package/dist/commands/channel/index.js +3 -3
- package/dist/commands/channel/index.js.map +1 -1
- package/dist/commands/channel/list.d.ts +1 -1
- package/dist/commands/channel/list.js +1 -1
- package/dist/commands/channel/rm.d.ts +1 -1
- package/dist/commands/channel/rm.js +1 -1
- package/dist/commands/channel/store/lock.d.ts +1 -1
- package/dist/commands/channel/store/lock.js +1 -1
- package/dist/commands/channel/store/paths.js +1 -1
- package/dist/commands/channel/store/paths.js.map +1 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +197 -91
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/uninstall.d.ts +4 -4
- package/dist/commands/uninstall.js +12 -12
- package/dist/commands/uninstall.js.map +1 -1
- package/dist/commands/update.d.ts +7 -2
- package/dist/commands/update.d.ts.map +1 -1
- package/dist/commands/update.js +161 -61
- package/dist/commands/update.js.map +1 -1
- package/dist/commands/upgrade.js +2 -2
- package/dist/commands/upgrade.js.map +1 -1
- package/dist/commands/workflow.d.ts +4 -4
- package/dist/commands/workflow.d.ts.map +1 -1
- package/dist/commands/workflow.js +10 -9
- package/dist/commands/workflow.js.map +1 -1
- package/dist/configurators/cursor.d.ts +2 -2
- package/dist/configurators/cursor.js +4 -4
- package/dist/configurators/cursor.js.map +1 -1
- package/dist/configurators/index.d.ts.map +1 -1
- package/dist/configurators/index.js +4 -4
- package/dist/configurators/index.js.map +1 -1
- package/dist/configurators/shared.d.ts +10 -10
- package/dist/configurators/shared.d.ts.map +1 -1
- package/dist/configurators/shared.js +32 -32
- package/dist/configurators/shared.js.map +1 -1
- package/dist/configurators/workflow.d.ts +6 -6
- package/dist/configurators/workflow.js +1 -1
- package/dist/constants/paths.d.ts +24 -24
- package/dist/constants/paths.d.ts.map +1 -1
- package/dist/constants/paths.js +16 -16
- package/dist/constants/paths.js.map +1 -1
- package/dist/migrations/manifests/0.2.10.json +374 -0
- package/dist/migrations/manifests/0.3.0.json +89 -0
- package/dist/migrations/manifests/0.3.1.json +32 -0
- package/dist/templates/common/bundled-skills/{trellis-cursor2plus-setup → cstl-cursor2plus-setup}/SKILL.md +15 -14
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/SKILL.md +75 -75
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/add-project-local-conventions.md +19 -19
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/change-agents.md +8 -8
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/change-context-loading.md +26 -26
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/change-hooks.md +9 -9
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/change-skills-or-commands.md +8 -8
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/change-spec-structure.md +17 -17
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/change-task-lifecycle.md +46 -46
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/change-workflow.md +18 -18
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/customize-local/overview.md +55 -55
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/local-architecture/context-injection.md +20 -20
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/generated-files.md +83 -0
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/local-architecture/overview.md +15 -15
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/local-architecture/spec-system.md +12 -12
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/local-architecture/task-system.md +34 -34
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/local-architecture/workflow.md +8 -8
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/local-architecture/workspace-memory.md +19 -19
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/platform-files/agents.md +12 -12
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/platform-files/hooks-and-settings.md +7 -7
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/platform-files/overview.md +9 -9
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/platform-files/platform-map.md +7 -7
- package/dist/templates/common/bundled-skills/{trellis-meta → cstl-meta}/references/platform-files/skills-and-commands.md +19 -19
- package/dist/templates/common/bundled-skills/{trellis-micro-grill → cstl-micro-grill}/SKILL.md +62 -47
- package/dist/templates/common/bundled-skills/{trellis-skill-creator → cstl-skill-creator}/SKILL.md +44 -44
- package/dist/templates/common/bundled-skills/{trellis-skill-creator → cstl-skill-creator}/references/authoring-rules.md +97 -97
- package/dist/templates/common/bundled-skills/{trellis-skill-creator/references/trellis-skill-locations.md → cstl-skill-creator/references/cstl-skill-locations.md} +52 -52
- package/dist/templates/common/bundled-skills/{trellis-skill-creator → cstl-skill-creator}/references/review-checklist.md +47 -47
- package/dist/templates/common/bundled-skills/{trellis-spec-bootstrap → cstl-spec-bootstrap}/SKILL.md +6 -6
- package/dist/templates/common/bundled-skills/{trellis-spec-bootstrap → cstl-spec-bootstrap}/references/repository-analysis.md +1 -1
- package/dist/templates/common/bundled-skills/{trellis-spec-bootstrap → cstl-spec-bootstrap}/references/spec-task-planning.md +3 -3
- package/dist/templates/common/bundled-skills/{trellis-spec-bootstrap → cstl-spec-bootstrap}/references/spec-writing.md +1 -1
- package/dist/templates/common/commands/continue.md +24 -24
- package/dist/templates/common/commands/finish-work.md +5 -5
- package/dist/templates/common/commands/start.md +20 -20
- package/dist/templates/common/index.d.ts +1 -1
- package/dist/templates/common/index.d.ts.map +1 -1
- package/dist/templates/common/skills/before-dev.md +4 -4
- package/dist/templates/common/skills/brainstorm.md +188 -164
- package/dist/templates/common/skills/break-loop.md +3 -3
- package/dist/templates/common/skills/check.md +5 -5
- package/dist/templates/common/skills/update-spec.md +4 -4
- package/dist/templates/cursor/agents/{trellis-check.md → cstl-check.md} +14 -14
- package/dist/templates/cursor/agents/{trellis-implement.md → cstl-implement.md} +14 -14
- package/dist/templates/cursor/agents/{trellis-research.md → cstl-research.md} +11 -11
- package/dist/templates/cursor/commands/cursor2plus-setup.md +15 -15
- package/dist/templates/cursor/fixtures/expected-rules.d.ts +1 -1
- package/dist/templates/cursor/fixtures/expected-rules.d.ts.map +1 -1
- package/dist/templates/cursor/fixtures/expected-rules.js +2 -2
- package/dist/templates/cursor/fixtures/expected-rules.js.map +1 -1
- package/dist/templates/cursor/rules/{trellis-subagent-dispatch.mdc → cstl-subagent-dispatch.mdc} +4 -4
- package/dist/templates/cursor/rules/{trellis-triage.mdc → cstl-triage.mdc} +3 -3
- package/dist/templates/cursor/rules/retrieval-routing.mdc +4 -4
- package/dist/templates/extract.d.ts +1 -1
- package/dist/templates/extract.js +1 -1
- package/dist/templates/markdown/agents.md +13 -13
- package/dist/templates/markdown/prompts/run-semantic-slice-12.md.txt +1 -1
- package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +634 -634
- package/dist/templates/markdown/spec/guides/cursor-context-injection-guide.md.txt +5 -5
- package/dist/templates/markdown/spec/guides/cursor-semantic-compliance.md.txt +7 -1
- package/dist/templates/markdown/spec/guides/cursor-subagent-policy.md.txt +393 -391
- package/dist/templates/markdown/spec/guides/durable-learning-decision-guide.md.txt +14 -14
- package/dist/templates/markdown/spec/guides/execution-strategy.md.txt +5 -5
- package/dist/templates/markdown/spec/guides/index.md.txt +3 -2
- package/dist/templates/markdown/spec/guides/retrieval-daily-guide.md.txt +10 -10
- package/dist/templates/markdown/workspace-index.md +3 -3
- package/dist/templates/markdown/worktree.yaml.txt +1 -1
- package/dist/templates/shared-hooks/index.d.ts +2 -2
- package/dist/templates/shared-hooks/index.js +2 -2
- package/dist/templates/shared-hooks/inject-retrieval-plan.py +3 -3
- package/dist/templates/shared-hooks/inject-shell-session-context.py +7 -7
- package/dist/templates/shared-hooks/inject-subagent-context.py +4 -4
- package/dist/templates/shared-hooks/inject-workflow-state.py +37 -37
- package/dist/templates/shared-hooks/research-end-retrieval-pack.py +2 -2
- package/dist/templates/shared-hooks/session-start.py +16 -16
- package/dist/templates/trellis/config/execution-strategy-rules.json +1 -1
- package/dist/templates/trellis/config.yaml +5 -25
- package/dist/templates/trellis/index.d.ts +2 -2
- package/dist/templates/trellis/index.js +2 -2
- package/dist/templates/trellis/local/README.md +15 -13
- package/dist/templates/trellis/local/patch_wpelc8.py +7 -7
- package/dist/templates/trellis/local/subagent-models.json.example +1 -1
- package/dist/templates/trellis/local/trellis-task-models.json.example +3 -3
- package/dist/templates/trellis/local/trellis-task-models.json5.example +5 -5
- package/dist/templates/trellis/local/trellis_task_models_config.py +6 -6
- package/dist/templates/trellis/scripts/add_session.py +20 -20
- package/dist/templates/trellis/scripts/common/active_task.py +2 -2
- package/dist/templates/trellis/scripts/common/artifact_search.py +587 -587
- package/dist/templates/trellis/scripts/common/cli_adapter.py +3 -3
- package/dist/templates/trellis/scripts/common/codebase_retrieval_router.py +6 -6
- package/dist/templates/trellis/scripts/common/config.py +3 -3
- package/dist/templates/trellis/scripts/common/developer.py +2 -2
- package/dist/templates/trellis/scripts/common/execution_strategy.py +1 -1
- package/dist/templates/trellis/scripts/common/packages_context.py +23 -23
- package/dist/templates/trellis/scripts/common/parent_orchestration.py +702 -702
- package/dist/templates/trellis/scripts/common/paths.py +107 -107
- package/dist/templates/trellis/scripts/common/project_file_stats.py +1 -1
- package/dist/templates/trellis/scripts/common/retrieval_agent_instructions.py +1 -1
- package/dist/templates/trellis/scripts/common/safe_commit.py +31 -31
- package/dist/templates/trellis/scripts/common/session_context.py +1159 -1159
- package/dist/templates/trellis/scripts/common/session_memory.py +360 -360
- package/dist/templates/trellis/scripts/common/smart_search_evidence.py +514 -514
- package/dist/templates/trellis/scripts/common/smart_search_resolve.py +1 -1
- package/dist/templates/trellis/scripts/common/subagent_dispatch.py +7 -7
- package/dist/templates/trellis/scripts/common/task_context.py +1 -1
- package/dist/templates/trellis/scripts/common/task_dashboard.py +140 -140
- package/dist/templates/trellis/scripts/common/task_gates.py +2056 -2034
- package/dist/templates/trellis/scripts/common/task_store.py +1594 -1594
- package/dist/templates/trellis/scripts/common/task_utils.py +3 -3
- package/dist/templates/trellis/scripts/common/tasks.py +1 -1
- package/dist/templates/trellis/scripts/common/trellis_config.py +3 -3
- package/dist/templates/trellis/scripts/common/workflow_phase.py +1 -1
- package/dist/templates/trellis/scripts/cursor_retrieval_probe.py +3 -3
- package/dist/templates/trellis/scripts/cursor_retrieval_probe_prompt.md +11 -11
- package/dist/templates/trellis/scripts/hooks/linear_sync.py +8 -8
- package/dist/templates/trellis/scripts/init_developer.py +2 -2
- package/dist/templates/trellis/scripts/retrieval_probe_matrix_template.json +4 -4
- package/dist/templates/trellis/scripts/route_codebase_retrieval.py +1 -1
- package/dist/templates/trellis/scripts/task.py +918 -918
- package/dist/templates/trellis/tasks/templates/release-readiness/implement.md +2 -2
- package/dist/templates/trellis/workflow.md +805 -805
- package/dist/types/ai-tools.d.ts +1 -1
- package/dist/types/ai-tools.d.ts.map +1 -1
- package/dist/types/ai-tools.js +1 -1
- package/dist/types/ai-tools.js.map +1 -1
- package/dist/types/migration.d.ts +1 -1
- package/dist/types/migration.d.ts.map +1 -1
- package/dist/utils/agents-md.d.ts +37 -0
- package/dist/utils/agents-md.d.ts.map +1 -0
- package/dist/utils/agents-md.js +82 -0
- package/dist/utils/agents-md.js.map +1 -0
- package/dist/utils/codebase-retrieval-router.js +5 -5
- package/dist/utils/codebase-retrieval-router.js.map +1 -1
- package/dist/utils/manifest-prune.d.ts +2 -2
- package/dist/utils/manifest-prune.js +4 -4
- package/dist/utils/manifest-prune.js.map +1 -1
- package/dist/utils/mirror-check.d.ts +3 -1
- package/dist/utils/mirror-check.d.ts.map +1 -1
- package/dist/utils/mirror-check.js +22 -11
- package/dist/utils/mirror-check.js.map +1 -1
- package/dist/utils/project-capabilities.d.ts +14 -3
- package/dist/utils/project-capabilities.d.ts.map +1 -1
- package/dist/utils/project-capabilities.js +127 -17
- package/dist/utils/project-capabilities.js.map +1 -1
- package/dist/utils/readiness.d.ts +10 -0
- package/dist/utils/readiness.d.ts.map +1 -1
- package/dist/utils/readiness.js +6 -3
- package/dist/utils/readiness.js.map +1 -1
- package/dist/utils/retrieval-agent-instructions.js +1 -1
- package/dist/utils/retrieval-agent-instructions.js.map +1 -1
- package/dist/utils/retrieval-execution-telemetry.js +1 -1
- package/dist/utils/retrieval-execution-telemetry.js.map +1 -1
- package/dist/utils/template-fetcher.js +1 -1
- package/dist/utils/template-fetcher.js.map +1 -1
- package/dist/utils/template-hash.d.ts +2 -2
- package/dist/utils/template-hash.d.ts.map +1 -1
- package/dist/utils/template-hash.js +12 -10
- package/dist/utils/template-hash.js.map +1 -1
- package/dist/utils/workflow-dir.d.ts +13 -0
- package/dist/utils/workflow-dir.d.ts.map +1 -0
- package/dist/utils/workflow-dir.js +35 -0
- package/dist/utils/workflow-dir.js.map +1 -0
- package/dist/utils/workflow-ownership.d.ts +36 -0
- package/dist/utils/workflow-ownership.d.ts.map +1 -0
- package/dist/utils/workflow-ownership.js +137 -0
- package/dist/utils/workflow-ownership.js.map +1 -0
- package/dist/utils/workflow-resolver.d.ts +1 -1
- package/dist/utils/workflow-resolver.js +1 -1
- package/package.json +3 -4
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/generated-files.md +0 -83
- /package/bin/{trellis.js → cstl.js} +0 -0
- /package/dist/templates/common/bundled-skills/{trellis-spec-bootstrap → cstl-spec-bootstrap}/references/mcp-setup.md +0 -0
|
@@ -4,7 +4,7 @@ The goal is to discover the project's real architecture before writing rules. Do
|
|
|
4
4
|
|
|
5
5
|
## Analysis Order
|
|
6
6
|
|
|
7
|
-
1. Read the existing `.
|
|
7
|
+
1. Read the existing `.cstl/spec/` tree and note which files are templates, outdated, or already project-specific.
|
|
8
8
|
2. Inspect package manifests, build scripts, workspace config, and top-level documentation to identify packages and runtime layers.
|
|
9
9
|
3. Use GitNexus for execution flows, module clusters, dependency hubs, and impact-sensitive areas.
|
|
10
10
|
4. Use ABCoder or language-native tooling for exact signatures, types, class boundaries, and implementation examples.
|
|
@@ -20,7 +20,7 @@ When a Trellis task is useful, write a concise PRD with these sections:
|
|
|
20
20
|
# Fill <package-or-layer> Trellis Specs
|
|
21
21
|
|
|
22
22
|
## Goal
|
|
23
|
-
Write project-specific `.
|
|
23
|
+
Write project-specific `.cstl/spec/` guidance for <scope>.
|
|
24
24
|
|
|
25
25
|
## Scope
|
|
26
26
|
- Spec directory:
|
|
@@ -32,8 +32,8 @@ Write project-specific `.trellis/spec/` guidance for <scope>.
|
|
|
32
32
|
Summarize the concrete findings from repository analysis.
|
|
33
33
|
|
|
34
34
|
## Files To Create Or Update
|
|
35
|
-
- `.
|
|
36
|
-
- `.
|
|
35
|
+
- `.cstl/spec/.../index.md`
|
|
36
|
+
- `.cstl/spec/.../<topic>.md`
|
|
37
37
|
|
|
38
38
|
## Rules
|
|
39
39
|
- Adapt the spec file set to the real codebase.
|
|
@@ -64,7 +64,7 @@ Avoid passing raw `process.argv` or unvalidated config objects into shared helpe
|
|
|
64
64
|
Before finishing:
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
|
-
grep -R "To be filled\\|TODO: fill\\|placeholder" .
|
|
67
|
+
grep -R "To be filled\\|TODO: fill\\|placeholder" .cstl/spec
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
Also check links, index files, and whether any spec still describes a template rather than this repository.
|
|
@@ -1,46 +1,46 @@
|
|
|
1
|
-
# Continue Selected Task
|
|
2
|
-
|
|
3
|
-
Resume work only when this live session already has a `selected_task`. If no task is selected, show the Task Dashboard and ask for an explicit route.
|
|
1
|
+
# Continue Selected Task
|
|
2
|
+
|
|
3
|
+
Resume work only when this live session already has a `selected_task`. If no task is selected, show the Task Dashboard and ask for an explicit route.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## Step 1: Load Framework Context
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
{{PYTHON_CMD}} ./.
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
Confirms: selected task, Task Dashboard, git state, recent commits.
|
|
14
|
-
|
|
15
|
-
If the output says `Selected task: none`, do not auto-resume a previous or unique task. Show the dashboard and ask the user to choose one route:
|
|
16
|
-
|
|
17
|
-
- select a task with `{{PYTHON_CMD}} ./.
|
|
18
|
-
- create a task
|
|
19
|
-
- inspect details
|
|
20
|
-
- continue without a task for No Task / Micro-Grill work
|
|
7
|
+
## Step 1: Load Framework Context
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Confirms: selected task, Task Dashboard, git state, recent commits.
|
|
14
|
+
|
|
15
|
+
If the output says `Selected task: none`, do not auto-resume a previous or unique task. Show the dashboard and ask the user to choose one route:
|
|
16
|
+
|
|
17
|
+
- select a task with `{{PYTHON_CMD}} ./.cstl/scripts/task.py select <task>`
|
|
18
|
+
- create a task
|
|
19
|
+
- inspect details
|
|
20
|
+
- continue without a task for No Task / Micro-Grill work
|
|
21
21
|
|
|
22
22
|
## Step 2: Load the Phase Index
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
|
-
{{PYTHON_CMD}} ./.
|
|
25
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py --mode phase
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
Shows the Phase Index (Plan / Execute / Finish) with routing + skill mapping.
|
|
29
29
|
|
|
30
30
|
## Step 3: Decide Where You Are
|
|
31
31
|
|
|
32
|
-
When a task is selected, `get_context.py` shows the selected task's `status` field. Route by `status` + artifact presence. This command replaces the user needing to remember the Trellis flow; it does not itself approve implementation.
|
|
32
|
+
When a task is selected, `get_context.py` shows the selected task's `status` field. Route by `status` + artifact presence. This command replaces the user needing to remember the Trellis flow; it does not itself approve implementation.
|
|
33
33
|
|
|
34
|
-
- `status=planning` + no `prd.md` → **1.1** (load `
|
|
34
|
+
- `status=planning` + no `prd.md` → **1.1** (load `cstl-brainstorm`)
|
|
35
35
|
- `status=planning` + `prd.md` only → decide whether the task is lightweight or complex. Lightweight can move to **1.4** review; complex returns to **1.1** to add `design.md` + `implement.md`.
|
|
36
36
|
- `status=planning` + complex artifacts complete + sub-agent jsonl not curated (only the seed `_example` row) → **1.3**
|
|
37
|
-
- `status=planning` + required artifacts complete + required jsonl curated or inline mode → execution gate (run `task.py start-execution <task> --check`, report PASS, ask for explicit execution approval, then run `task.py start-execution <task> --approved`)
|
|
37
|
+
- `status=planning` + required artifacts complete + required jsonl curated or inline mode → execution gate (run `task.py start-execution <task> --check`, report PASS, ask for explicit execution approval, then run `task.py start-execution <task> --approved`)
|
|
38
38
|
- `status=in_progress` + implementation not started → **2.1**
|
|
39
39
|
- `status=in_progress` + implementation done, not yet checked → **2.2**
|
|
40
40
|
- `status=in_progress` + check passed → **3.1**
|
|
41
41
|
- `status=completed` (rare; usually archived immediately) → archive flow
|
|
42
42
|
|
|
43
|
-
Phase rules (full detail in `.
|
|
43
|
+
Phase rules (full detail in `.cstl/workflow.md`):
|
|
44
44
|
|
|
45
45
|
1. Run steps **in order** within a phase — `[required]` steps must not be skipped
|
|
46
46
|
2. `[once]` steps are already done if the required output exists. `prd.md` alone can be enough only for lightweight tasks; complex tasks also need `design.md` and `implement.md`.
|
|
@@ -51,7 +51,7 @@ Phase rules (full detail in `.trellis/workflow.md`):
|
|
|
51
51
|
Once you know which step to resume at:
|
|
52
52
|
|
|
53
53
|
```bash
|
|
54
|
-
{{PYTHON_CMD}} ./.
|
|
54
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py --mode phase --step <X.X> --platform {{CLI_FLAG}}
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
Follow the loaded instructions. After each `[required]` step completes, move to the next.
|
|
@@ -60,4 +60,4 @@ Follow the loaded instructions. After each `[required]` step completes, move to
|
|
|
60
60
|
|
|
61
61
|
## Reference
|
|
62
62
|
|
|
63
|
-
Full workflow and detailed phase steps live in `.
|
|
63
|
+
Full workflow and detailed phase steps live in `.cstl/workflow.md`. This command is only an entry point — the canonical guidance is there.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Wrap up the current session: archive the selected task (and any other completed-but-unarchived tasks the user wants to clean up) and record the session journal. Code commits are NOT done here — those happen in workflow Phase 3.4 before you invoke this command.
|
|
4
4
|
|
|
5
|
-
Before archive, confirm `verify.md` includes Phase 3.3 **Learning decision** (`update-spec` | `no-update` | `unsure`) and gate-compatible evidence per `.
|
|
5
|
+
Before archive, confirm `verify.md` includes Phase 3.3 **Learning decision** (`update-spec` | `no-update` | `unsure`) and gate-compatible evidence per `.cstl/spec/guides/durable-learning-decision-guide.md`. Run `task.py archive <task> --check` when unsure.
|
|
6
6
|
|
|
7
7
|
## Evidence pack reference (optional — graceful skip)
|
|
8
8
|
|
|
@@ -19,7 +19,7 @@ Pack format: `version`, `source` (`retrieval-pack-orchestrator`), `contextPack.s
|
|
|
19
19
|
## Step 1: Survey current state
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
{{PYTHON_CMD}} ./.
|
|
22
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py --mode record
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
This prints:
|
|
@@ -38,7 +38,7 @@ Run:
|
|
|
38
38
|
git status --porcelain
|
|
39
39
|
```
|
|
40
40
|
|
|
41
|
-
Filter out paths under `.
|
|
41
|
+
Filter out paths under `.cstl/workspace/` and `.cstl/tasks/` — those are managed by `add_session.py` and `task.py archive` auto-commits and will appear dirty as part of this skill's own work.
|
|
42
42
|
|
|
43
43
|
For each remaining dirty path, decide whether it belongs to **the selected task** or to **other parallel work** (e.g., another terminal window editing the same repo). Heuristics:
|
|
44
44
|
|
|
@@ -59,7 +59,7 @@ Then route:
|
|
|
59
59
|
## Step 3: Archive task(s)
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
|
-
{{PYTHON_CMD}} ./.
|
|
62
|
+
{{PYTHON_CMD}} ./.cstl/scripts/task.py archive <task-name>
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
At minimum: the selected task (if any). Plus any extra tasks the user confirmed in Step 1. Each archive produces a `chore(task): archive ...` commit via the script's auto-commit.
|
|
@@ -69,7 +69,7 @@ If there is no selected task and the user did not confirm any cleanup archives,
|
|
|
69
69
|
## Step 4: Record session journal
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
{{PYTHON_CMD}} ./.
|
|
72
|
+
{{PYTHON_CMD}} ./.cstl/scripts/add_session.py \
|
|
73
73
|
--title "Session Title" \
|
|
74
74
|
--commit "hash1,hash2" \
|
|
75
75
|
--summary "Brief summary"
|
|
@@ -8,7 +8,7 @@ Enter or refresh the Trellis Framework Context. This is a dashboard entry surfac
|
|
|
8
8
|
Identity, git status, selected task, Task Dashboard, journal location.
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
|
-
{{PYTHON_CMD}} ./.
|
|
11
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py
|
|
12
12
|
```
|
|
13
13
|
|
|
14
14
|
If this output includes a line beginning `Trellis update available:`, copy the full line verbatim when summarizing session context. Do not shorten operational command hints.
|
|
@@ -17,18 +17,18 @@ If this output includes a line beginning `Trellis update available:`, copy the f
|
|
|
17
17
|
Compact Phase Index, request triage rules, planning artifact contract, and the step-detail command.
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
{{PYTHON_CMD}} ./.
|
|
20
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py --mode phase
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
Full guide in `.
|
|
23
|
+
Full guide in `.cstl/workflow.md` (read on demand).
|
|
24
24
|
|
|
25
25
|
## Step 3: Guideline indexes
|
|
26
26
|
Discover packages + spec layers, then read each relevant index file.
|
|
27
27
|
|
|
28
28
|
```bash
|
|
29
|
-
{{PYTHON_CMD}} ./.
|
|
30
|
-
cat .
|
|
31
|
-
cat .
|
|
29
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py --mode packages
|
|
30
|
+
cat .cstl/spec/guides/index.md
|
|
31
|
+
cat .cstl/spec/<package>/<layer>/index.md # for each relevant layer
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
Index files list the specific guideline docs to read when you actually start coding.
|
|
@@ -36,18 +36,18 @@ Index files list the specific guideline docs to read when you actually start cod
|
|
|
36
36
|
## Step 4: Decide next action
|
|
37
37
|
From Step 1 you know whether a task is selected.
|
|
38
38
|
|
|
39
|
-
- If `Selected task: none` → show the Task Dashboard; do **not** load `
|
|
40
|
-
- If a task **is** selected and you need the next workflow step → use `
|
|
39
|
+
- If `Selected task: none` → show the Task Dashboard; do **not** load `cstl-continue`. For a **small** request without a task, use `cstl-micro-grill` first.
|
|
40
|
+
- If a task **is** selected and you need the next workflow step → use `cstl-continue` instead of repeating Steps 1–3 here.
|
|
41
41
|
|
|
42
42
|
If `Selected task: none`, ask the user to choose: select a task, create a task, inspect details, or continue without a task.
|
|
43
43
|
|
|
44
44
|
If a task is selected, check the task directory:
|
|
45
45
|
|
|
46
|
-
- **Selected task status `planning` + no `prd.md`** → Phase 1.1. Load the `
|
|
46
|
+
- **Selected task status `planning` + no `prd.md`** → Phase 1.1. Load the `cstl-brainstorm` skill.
|
|
47
47
|
- **Selected task status `planning` + `prd.md` exists** → stay in Planning / Execution Gate. Lightweight tasks can be PRD-only; complex tasks need `design.md` + `implement.md`. Run `task.py start-execution <task> --check` and request explicit execution approval before execution.
|
|
48
48
|
- **Selected task status `in_progress`** → Phase 2 step 2.1. Load the step detail:
|
|
49
49
|
```bash
|
|
50
|
-
{{PYTHON_CMD}} ./.
|
|
50
|
+
{{PYTHON_CMD}} ./.cstl/scripts/get_context.py --mode phase --step 2.1 --platform {{CLI_FLAG}}
|
|
51
51
|
```
|
|
52
52
|
- **No selected task** → use dashboard routing. Do not auto-select an existing task.
|
|
53
53
|
|
|
@@ -57,13 +57,13 @@ If a task is selected, check the task directory:
|
|
|
57
57
|
|
|
58
58
|
| User intent | Skill |
|
|
59
59
|
|---|---|
|
|
60
|
-
| Resume **selected** in-progress task | `
|
|
61
|
-
| New feature / unclear requirements | `
|
|
62
|
-
| Small request, no task yet | `
|
|
63
|
-
| About to write code | `
|
|
64
|
-
| Done coding / quality check | `
|
|
65
|
-
| Session wrap-up after Phase 3.4 commit | `
|
|
66
|
-
| Stuck / fixed same bug multiple times | `
|
|
67
|
-
| Learned something worth capturing | `
|
|
68
|
-
|
|
69
|
-
Full rules + anti-rationalization table in `.
|
|
60
|
+
| Resume **selected** in-progress task | `cstl-continue` |
|
|
61
|
+
| New feature / unclear requirements | `cstl-brainstorm` |
|
|
62
|
+
| Small request, no task yet | `cstl-micro-grill` |
|
|
63
|
+
| About to write code | `cstl-before-dev` |
|
|
64
|
+
| Done coding / quality check | `cstl-check` |
|
|
65
|
+
| Session wrap-up after Phase 3.4 commit | `cstl-finish-work` |
|
|
66
|
+
| Stuck / fixed same bug multiple times | `cstl-break-loop` |
|
|
67
|
+
| Learned something worth capturing | `cstl-update-spec` |
|
|
68
|
+
|
|
69
|
+
Full rules + anti-rationalization table in `.cstl/workflow.md`.
|
|
@@ -23,7 +23,7 @@ export interface CommonBundledSkillFile {
|
|
|
23
23
|
content: string;
|
|
24
24
|
}
|
|
25
25
|
export interface CommonBundledSkill {
|
|
26
|
-
/** Skill directory name, e.g. "
|
|
26
|
+
/** Skill directory name, e.g. "cstl-meta" */
|
|
27
27
|
name: string;
|
|
28
28
|
/** Files that must be written under the skill directory */
|
|
29
29
|
files: CommonBundledSkillFile[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAMtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAMpD;AAuCD;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,EAAE,CAM/D"}
|
|
@@ -2,14 +2,14 @@ Read the relevant development guidelines before starting your task.
|
|
|
2
2
|
|
|
3
3
|
Execute these steps:
|
|
4
4
|
|
|
5
|
-
1. **Read selected task artifacts**:
|
|
5
|
+
1. **Read selected task artifacts**:
|
|
6
6
|
- `prd.md` for requirements and acceptance criteria
|
|
7
7
|
- `design.md` if present for technical design
|
|
8
8
|
- `implement.md` if present for execution order and validation plan
|
|
9
9
|
|
|
10
10
|
2. **Discover packages and their spec layers**:
|
|
11
11
|
```bash
|
|
12
|
-
python3 ./.
|
|
12
|
+
python3 ./.cstl/scripts/get_context.py --mode packages
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
3. **Identify which specs apply** to your task based on:
|
|
@@ -19,7 +19,7 @@ Execute these steps:
|
|
|
19
19
|
|
|
20
20
|
4. **Read the spec index** for each relevant module:
|
|
21
21
|
```bash
|
|
22
|
-
cat .
|
|
22
|
+
cat .cstl/spec/<package>/<layer>/index.md
|
|
23
23
|
```
|
|
24
24
|
Follow the **"Pre-Development Checklist"** section in the index.
|
|
25
25
|
|
|
@@ -27,7 +27,7 @@ Execute these steps:
|
|
|
27
27
|
|
|
28
28
|
6. **Always read shared guides**:
|
|
29
29
|
```bash
|
|
30
|
-
cat .
|
|
30
|
+
cat .cstl/spec/guides/index.md
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
7. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
|