@pixelfactoryio/theway 0.14.1 → 0.16.0
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/README.md +2 -0
- package/dist/theway.js +1156 -291
- package/package.json +5 -2
- package/plugin/.claude-plugin/plugin.json +1 -1
- package/plugin/commands/archive.md +1 -0
- package/plugin/commands/document.md +2 -0
- package/plugin/commands/engineering.md +1 -129
- package/plugin/commands/list.md +1 -0
- package/plugin/commands/workflow.md +93 -35
- package/plugin/home/config.yaml +7 -36
- package/plugin/home/prompts/ci-diagnose.md +15 -0
- package/plugin/home/prompts/ci-fix.md +7 -0
- package/plugin/home/prompts/ci-wait.md +5 -0
- package/plugin/home/prompts/fix-check.md +7 -0
- package/plugin/home/{templates → prompts}/fix-spec-template.md +7 -1
- package/plugin/home/prompts/fix.md +9 -0
- package/plugin/home/prompts/grounding.md +7 -0
- package/plugin/home/prompts/implement.md +9 -0
- package/plugin/home/prompts/implementability.md +12 -0
- package/plugin/home/{templates → prompts}/light-spec-template.md +3 -1
- package/plugin/home/prompts/open-pr.md +5 -0
- package/plugin/home/prompts/reviewer.md +7 -0
- package/plugin/home/prompts/scaffold-light.md +38 -0
- package/plugin/home/prompts/scaffold-rules.md +22 -0
- package/plugin/home/prompts/scaffold.md +55 -0
- package/plugin/home/prompts/spec-fix.md +5 -0
- package/plugin/home/{standards → prompts}/spec-investigation.md +5 -4
- package/plugin/home/prompts/spec-reviewer.md +16 -0
- package/plugin/home/{templates → prompts}/spec-template.md +10 -1
- package/plugin/home/prompts/spec-triage.md +5 -0
- package/plugin/home/{standards → prompts}/tamm-framework.md +8 -0
- package/plugin/home/{templates → prompts}/tasks-template.md +3 -0
- package/plugin/home/prompts/triage.md +3 -0
- package/plugin/home/prompts/verdicts.md +11 -0
- package/plugin/home/schemas/step.v1.json +449 -0
- package/plugin/home/schemas/workflow.v1.json +110 -0
- package/plugin/home/standards/commits.md +1 -1
- package/plugin/home/standards/develop.md +2 -2
- package/plugin/home/standards/interaction.md +1 -1
- package/plugin/home/standards/sre.md +2 -2
- package/plugin/home/standards/web-development.md +3 -0
- package/plugin/home/steps/implement.yaml +7 -0
- package/plugin/home/steps/pr.yaml +21 -0
- package/plugin/home/steps/review.yaml +25 -0
- package/plugin/home/steps/scaffold-light.yaml +7 -0
- package/plugin/home/steps/scaffold.yaml +7 -0
- package/plugin/home/steps/spec-review.yaml +26 -0
- package/plugin/home/templates/source-tree-template.md +5 -0
- package/plugin/home/templates/tech-stack-template.md +7 -0
- package/plugin/home/workflows/agents.yaml +4 -1
- package/plugin/home/workflows/develop.yaml +4 -1
- package/plugin/home/workflows/engineering-light.yaml +7 -0
- package/plugin/home/workflows/engineering.yaml +7 -0
- package/plugin/workflows/run-pipeline.js +466 -464
- package/plugin/home/standards/spec-review.md +0 -61
- /package/plugin/home/{lenses → prompts}/conformance.md +0 -0
- /package/plugin/home/{lenses → prompts}/correctness.md +0 -0
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
+
version: theway.step/v1
|
|
3
|
+
description: Review the diff through each lens, triage the findings, fix the confirmed ones and check the fixes
|
|
4
|
+
params:
|
|
5
|
+
rounds: {default: 1, description: Maximum review rounds}
|
|
6
|
+
lenses: {default: [conformance, correctness], description: "One reviewer per lens, by prompt name"}
|
|
7
|
+
model: {default: opus, description: "The reviewers, the triage and the fix check"}
|
|
8
|
+
fix_model: {default: opus, description: The fix agent of each round}
|
|
9
|
+
do:
|
|
10
|
+
- loop:
|
|
11
|
+
max: "${rounds}"
|
|
12
|
+
until: no-confirmed
|
|
13
|
+
exhausted: continue
|
|
14
|
+
do:
|
|
15
|
+
- foreach: "${lenses}"
|
|
16
|
+
parallel: true
|
|
17
|
+
do:
|
|
18
|
+
- agent: {prompt: [reviewer, "${item}"], returns: findings}
|
|
19
|
+
- when: findings
|
|
20
|
+
do:
|
|
21
|
+
- agent: {prompt: [verdicts, triage], returns: verdicts}
|
|
22
|
+
- when: confirmed
|
|
23
|
+
do:
|
|
24
|
+
- agent: {prompt: fix, returns: work, model: "${fix_model}"}
|
|
25
|
+
- agent: {prompt: fix-check, returns: resolutions}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
+
version: theway.step/v1
|
|
3
|
+
description: Investigate a small request and write its light spec and tasks, or escalate
|
|
4
|
+
params:
|
|
5
|
+
model: {default: opus, description: The scaffolder when the step runs through agents}
|
|
6
|
+
do:
|
|
7
|
+
- agent: {prompt: [tamm-framework, spec-investigation, scaffold-rules, light-spec-template, tasks-template, scaffold-light], returns: scaffold}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
+
version: theway.step/v1
|
|
3
|
+
description: Investigate the request and write the change's spec, tasks and design
|
|
4
|
+
params:
|
|
5
|
+
model: {default: opus, description: The scaffolder when the step runs through agents}
|
|
6
|
+
do:
|
|
7
|
+
- agent: {prompt: [tamm-framework, spec-investigation, scaffold-rules, spec-template, fix-spec-template, tasks-template, scaffold], returns: scaffold}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
+
version: theway.step/v1
|
|
3
|
+
description: Review the change's spec through each lens, triage, fix the confirmed findings and stop on a decision
|
|
4
|
+
params:
|
|
5
|
+
rounds: {default: 1, description: Maximum review rounds}
|
|
6
|
+
lenses: {default: [grounding, implementability], description: "One critic per lens, by prompt name"}
|
|
7
|
+
model: {default: opus, description: "The critics, the triage and the fix agent"}
|
|
8
|
+
on_decision: {default: open question, description: The message a confirmed decision stops the run with}
|
|
9
|
+
do:
|
|
10
|
+
- loop:
|
|
11
|
+
max: "${rounds}"
|
|
12
|
+
until: no-confirmed
|
|
13
|
+
exhausted: continue
|
|
14
|
+
do:
|
|
15
|
+
- foreach: "${lenses}"
|
|
16
|
+
parallel: true
|
|
17
|
+
do:
|
|
18
|
+
- agent: {prompt: [spec-reviewer, "${item}"], returns: findings}
|
|
19
|
+
- when: findings
|
|
20
|
+
do:
|
|
21
|
+
- agent: {prompt: [verdicts, spec-triage], returns: verdicts}
|
|
22
|
+
- when: confirmed
|
|
23
|
+
do:
|
|
24
|
+
- agent: {prompt: spec-fix, returns: edits}
|
|
25
|
+
- when: decision
|
|
26
|
+
block: "${on_decision}"
|
|
@@ -54,6 +54,7 @@ Source code organization and structure for {{PROJECT_NAME}}.
|
|
|
54
54
|
{{DIR_1_DESCRIPTION}}
|
|
55
55
|
|
|
56
56
|
**Key Files:**
|
|
57
|
+
|
|
57
58
|
- `{{FILE_1}}` - {{FILE_1_PURPOSE}}
|
|
58
59
|
- `{{FILE_2}}` - {{FILE_2_PURPOSE}}
|
|
59
60
|
|
|
@@ -61,6 +62,7 @@ Source code organization and structure for {{PROJECT_NAME}}.
|
|
|
61
62
|
{{DIR_2_DESCRIPTION}}
|
|
62
63
|
|
|
63
64
|
**Key Files:**
|
|
65
|
+
|
|
64
66
|
- `{{FILE_1}}` - {{FILE_1_PURPOSE}}
|
|
65
67
|
- `{{FILE_2}}` - {{FILE_2_PURPOSE}}
|
|
66
68
|
|
|
@@ -68,6 +70,7 @@ Source code organization and structure for {{PROJECT_NAME}}.
|
|
|
68
70
|
{{DIR_3_DESCRIPTION}}
|
|
69
71
|
|
|
70
72
|
**Key Files:**
|
|
73
|
+
|
|
71
74
|
- `{{FILE_1}}` - {{FILE_1_PURPOSE}}
|
|
72
75
|
- `{{FILE_2}}` - {{FILE_2_PURPOSE}}
|
|
73
76
|
|
|
@@ -76,11 +79,13 @@ Source code organization and structure for {{PROJECT_NAME}}.
|
|
|
76
79
|
{{MODULE_ORGANIZATION_DESCRIPTION}}
|
|
77
80
|
|
|
78
81
|
### {{MODULE_1}}
|
|
82
|
+
|
|
79
83
|
- **Location:** `{{MODULE_1_PATH}}`
|
|
80
84
|
- **Purpose:** {{MODULE_1_PURPOSE}}
|
|
81
85
|
- **Dependencies:** {{MODULE_1_DEPS}}
|
|
82
86
|
|
|
83
87
|
### {{MODULE_2}}
|
|
88
|
+
|
|
84
89
|
- **Location:** `{{MODULE_2_PATH}}`
|
|
85
90
|
- **Purpose:** {{MODULE_2_PURPOSE}}
|
|
86
91
|
- **Dependencies:** {{MODULE_2_DEPS}}
|
|
@@ -70,6 +70,7 @@ Technology choices, dependencies, and rationale for {{PROJECT_NAME}}.
|
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
**Key Libraries:**
|
|
73
|
+
|
|
73
74
|
- **{{LIBRARY_1}}** ({{VERSION}}) - {{LIBRARY_1_PURPOSE}}
|
|
74
75
|
- **{{LIBRARY_2}}** ({{VERSION}}) - {{LIBRARY_2_PURPOSE}}
|
|
75
76
|
- **{{LIBRARY_3}}** ({{VERSION}}) - {{LIBRARY_3_PURPOSE}}
|
|
@@ -86,11 +87,13 @@ Technology choices, dependencies, and rationale for {{PROJECT_NAME}}.
|
|
|
86
87
|
[Omit this section if the repository has none.]
|
|
87
88
|
|
|
88
89
|
### Deployment Tools
|
|
90
|
+
|
|
89
91
|
- **Container Runtime:** {{CONTAINER_RUNTIME}} {{VERSION}}
|
|
90
92
|
- **Orchestration:** {{ORCHESTRATION}} {{VERSION}}
|
|
91
93
|
- **CI/CD:** {{CICD_PLATFORM}}
|
|
92
94
|
|
|
93
95
|
### Infrastructure as Code
|
|
96
|
+
|
|
94
97
|
- **Tool:** {{IAC_TOOL}} {{VERSION}}
|
|
95
98
|
- **State Management:** {{STATE_MANAGEMENT}}
|
|
96
99
|
- **Module Structure:** {{MODULE_STRUCTURE}}
|
|
@@ -99,12 +102,14 @@ Technology choices, dependencies, and rationale for {{PROJECT_NAME}}.
|
|
|
99
102
|
[Omit this section if the repository has none.]
|
|
100
103
|
|
|
101
104
|
### Primary Database
|
|
105
|
+
|
|
102
106
|
- **Type:** {{DB_TYPE}}
|
|
103
107
|
- **Technology:** {{DB_TECH}} {{VERSION}}
|
|
104
108
|
- **Driver:** {{DB_DRIVER}} {{VERSION}}
|
|
105
109
|
- **Migration Tool:** {{MIGRATION_TOOL}}
|
|
106
110
|
|
|
107
111
|
### Storage Solutions
|
|
112
|
+
|
|
108
113
|
- **Object Storage:** {{OBJECT_STORAGE}}
|
|
109
114
|
- **File Storage:** {{FILE_STORAGE}}
|
|
110
115
|
- **Cache:** {{CACHE_SOLUTION}} {{VERSION}}
|
|
@@ -128,11 +133,13 @@ Technology choices, dependencies, and rationale for {{PROJECT_NAME}}.
|
|
|
128
133
|
## Version Constraints
|
|
129
134
|
|
|
130
135
|
### Compatibility Requirements
|
|
136
|
+
|
|
131
137
|
- {{CONSTRAINT_1}}
|
|
132
138
|
- {{CONSTRAINT_2}}
|
|
133
139
|
- {{CONSTRAINT_3}}
|
|
134
140
|
|
|
135
141
|
### Update Policy
|
|
142
|
+
|
|
136
143
|
- **Major Versions:** {{MAJOR_VERSION_POLICY}}
|
|
137
144
|
- **Minor Versions:** {{MINOR_VERSION_POLICY}}
|
|
138
145
|
- **Patch Versions:** {{PATCH_VERSION_POLICY}}
|
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
#
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/workflow.v1.json
|
|
2
|
+
# Implement, review and open the PR through agents. A param an entry leaves out comes from workflow.defaults in
|
|
3
|
+
# config.yaml, else from the step file: theway steps lists them.
|
|
4
|
+
version: theway.workflow/v1
|
|
2
5
|
steps:
|
|
3
6
|
- implement:
|
|
4
7
|
- review:
|
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
#
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/workflow.v1.json
|
|
2
|
+
# The workflow /theway:workflow runs when no file sets default: true: the tasks done inline in your session, on the
|
|
3
|
+
# working tree, nothing committed.
|
|
4
|
+
version: theway.workflow/v1
|
|
2
5
|
agents: false
|
|
3
6
|
steps:
|
|
4
7
|
- implement:
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/workflow.v1.json
|
|
2
|
+
# The light path of /theway:engineering --light: a short spec and 1 to 3 tasks, reviewed by one grounding critic.
|
|
3
|
+
version: theway.workflow/v1
|
|
4
|
+
input: request
|
|
5
|
+
steps:
|
|
6
|
+
- scaffold-light: {agents: false}
|
|
7
|
+
- spec-review: {lenses: [grounding], on_decision: "escalated: run /theway:engineering <change-id>: <request> without --light"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/workflow.v1.json
|
|
2
|
+
# Investigate a request and write its spec and tasks, then review them. /theway:engineering runs it.
|
|
3
|
+
version: theway.workflow/v1
|
|
4
|
+
input: request
|
|
5
|
+
steps:
|
|
6
|
+
- scaffold: {agents: false}
|
|
7
|
+
- spec-review:
|