@pixelfactoryio/theway 0.14.1 → 0.15.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.
Files changed (57) hide show
  1. package/README.md +2 -0
  2. package/dist/theway.js +1156 -291
  3. package/package.json +5 -2
  4. package/plugin/.claude-plugin/plugin.json +1 -1
  5. package/plugin/commands/archive.md +1 -0
  6. package/plugin/commands/document.md +2 -0
  7. package/plugin/commands/engineering.md +1 -129
  8. package/plugin/commands/list.md +1 -0
  9. package/plugin/commands/workflow.md +85 -35
  10. package/plugin/home/config.yaml +7 -36
  11. package/plugin/home/prompts/ci-diagnose.md +15 -0
  12. package/plugin/home/prompts/ci-fix.md +7 -0
  13. package/plugin/home/prompts/ci-wait.md +5 -0
  14. package/plugin/home/prompts/fix-check.md +7 -0
  15. package/plugin/home/{templates → prompts}/fix-spec-template.md +7 -1
  16. package/plugin/home/prompts/fix.md +9 -0
  17. package/plugin/home/prompts/grounding.md +7 -0
  18. package/plugin/home/prompts/implement.md +9 -0
  19. package/plugin/home/prompts/implementability.md +12 -0
  20. package/plugin/home/{templates → prompts}/light-spec-template.md +3 -1
  21. package/plugin/home/prompts/open-pr.md +5 -0
  22. package/plugin/home/prompts/reviewer.md +7 -0
  23. package/plugin/home/prompts/scaffold-light.md +38 -0
  24. package/plugin/home/prompts/scaffold-rules.md +22 -0
  25. package/plugin/home/prompts/scaffold.md +55 -0
  26. package/plugin/home/prompts/spec-fix.md +5 -0
  27. package/plugin/home/{standards → prompts}/spec-investigation.md +5 -4
  28. package/plugin/home/prompts/spec-reviewer.md +16 -0
  29. package/plugin/home/{templates → prompts}/spec-template.md +10 -1
  30. package/plugin/home/prompts/spec-triage.md +5 -0
  31. package/plugin/home/{standards → prompts}/tamm-framework.md +8 -0
  32. package/plugin/home/{templates → prompts}/tasks-template.md +3 -0
  33. package/plugin/home/prompts/triage.md +3 -0
  34. package/plugin/home/prompts/verdicts.md +11 -0
  35. package/plugin/home/schemas/step.v1.json +449 -0
  36. package/plugin/home/schemas/workflow.v1.json +110 -0
  37. package/plugin/home/standards/commits.md +1 -1
  38. package/plugin/home/standards/develop.md +2 -2
  39. package/plugin/home/standards/interaction.md +1 -1
  40. package/plugin/home/standards/sre.md +2 -2
  41. package/plugin/home/standards/web-development.md +3 -0
  42. package/plugin/home/steps/implement.yaml +7 -0
  43. package/plugin/home/steps/pr.yaml +21 -0
  44. package/plugin/home/steps/review.yaml +25 -0
  45. package/plugin/home/steps/scaffold-light.yaml +7 -0
  46. package/plugin/home/steps/scaffold.yaml +7 -0
  47. package/plugin/home/steps/spec-review.yaml +26 -0
  48. package/plugin/home/templates/source-tree-template.md +5 -0
  49. package/plugin/home/templates/tech-stack-template.md +7 -0
  50. package/plugin/home/workflows/agents.yaml +4 -1
  51. package/plugin/home/workflows/develop.yaml +4 -1
  52. package/plugin/home/workflows/engineering-light.yaml +7 -0
  53. package/plugin/home/workflows/engineering.yaml +7 -0
  54. package/plugin/workflows/run-pipeline.js +466 -464
  55. package/plugin/home/standards/spec-review.md +0 -61
  56. /package/plugin/home/{lenses → prompts}/conformance.md +0 -0
  57. /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
- # Implement, review and open the PR through agents. Fields left out come from workflow.defaults in config.yaml.
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
- # The workflow /theway:workflow runs when no file sets default: true: the tasks done inline in your session, nothing committed.
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: