compound-workflow 1.8.0 → 1.9.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 +61 -69
- package/package.json +2 -8
- package/scripts/check-pack-readme.mjs +1 -16
- package/scripts/check-workflow-contracts.mjs +34 -44
- package/scripts/install-cli.mjs +273 -555
- package/src/AGENTS.md +59 -192
- package/src/{.agents/agents → agents}/research/best-practices-researcher.md +2 -2
- package/src/{.agents/commands → commands}/assess.md +4 -4
- package/src/commands/install.md +43 -0
- package/src/{.agents/commands → commands}/metrics.md +1 -1
- package/src/commands/workflow-agents.md +101 -0
- package/src/{.agents/commands → commands}/workflow-compound.md +1 -1
- package/src/{.agents/commands → commands}/workflow-plan.md +24 -33
- package/src/commands/workflow-work.md +836 -0
- package/src/{.agents/references → references}/README.md +1 -1
- package/src/{.agents/skills → skills}/capture-skill/SKILL.md +1 -1
- package/src/{.agents/skills → skills}/compound-docs/SKILL.md +6 -6
- package/src/{.agents/skills → skills}/compound-docs/references/yaml-schema.md +2 -2
- package/src/skills/setup-agents/SKILL.md +250 -0
- package/src/skills/standards/SKILL.md +79 -0
- package/src/skills/standards/references/architecture.md +228 -0
- package/src/skills/standards/references/code-quality.md +192 -0
- package/src/skills/standards/references/presentation.md +515 -0
- package/src/skills/standards/references/services.md +172 -0
- package/src/skills/standards/references/state-management.md +936 -0
- package/.claude-plugin/plugin.json +0 -7
- package/.cursor-plugin/plugin.json +0 -20
- package/.cursor-plugin/registration.json +0 -5
- package/scripts/check-version-parity.mjs +0 -36
- package/scripts/generate-platform-artifacts.mjs +0 -230
- package/src/.agents/commands/install.md +0 -51
- package/src/.agents/commands/workflow-work.md +0 -690
- package/src/.agents/registry.json +0 -48
- package/src/.agents/scripts/self-check.mjs +0 -227
- package/src/.agents/scripts/sync-opencode.mjs +0 -362
- package/src/.agents/skills/presentation-composability/SKILL.md +0 -72
- package/src/.agents/skills/react-ddd-mvc-frontend/SKILL.md +0 -51
- package/src/.agents/skills/react-ddd-mvc-frontend/references/feature-structure.md +0 -25
- package/src/.agents/skills/react-ddd-mvc-frontend/references/implementation-principles.md +0 -21
- package/src/.agents/skills/react-ddd-mvc-frontend/references/responsibility-gates.md +0 -41
- package/src/.agents/skills/react-ddd-mvc-frontend/references/source-map.md +0 -11
- package/src/.agents/skills/standards/SKILL.md +0 -747
- package/src/.agents/skills/xstate-actor-orchestration/SKILL.md +0 -197
- package/src/.agents/skills/xstate-actor-orchestration/agents/openai.yaml +0 -4
- package/src/.agents/skills/xstate-actor-orchestration/assets/statecharts/.gitkeep +0 -0
- package/src/.agents/skills/xstate-actor-orchestration/references/actor-system-patterns.md +0 -71
- package/src/.agents/skills/xstate-actor-orchestration/references/event-contracts.md +0 -73
- package/src/.agents/skills/xstate-actor-orchestration/references/functional-domain-patterns.md +0 -53
- package/src/.agents/skills/xstate-actor-orchestration/references/machine-structure-and-tags.md +0 -36
- package/src/.agents/skills/xstate-actor-orchestration/references/react-container-pattern.md +0 -45
- package/src/.agents/skills/xstate-actor-orchestration/references/reliability-observability.md +0 -39
- package/src/.agents/skills/xstate-actor-orchestration/references/skill-validation.md +0 -33
- package/src/.agents/skills/xstate-actor-orchestration/references/source-map.md +0 -44
- package/src/.agents/skills/xstate-actor-orchestration/references/statechart-review-and-signoff.md +0 -59
- package/src/.agents/skills/xstate-actor-orchestration/references/testing-strategy.md +0 -35
- package/src/.agents/skills/xstate-actor-orchestration/scripts/create-statechart-artifact.sh +0 -71
- package/src/.agents/skills/xstate-actor-orchestration/scripts/validate-skill.sh +0 -138
- package/src/generated/opencode.managed.json +0 -115
- /package/src/{.agents/agents → agents}/research/framework-docs-researcher.md +0 -0
- /package/src/{.agents/agents → agents}/research/git-history-analyzer.md +0 -0
- /package/src/{.agents/agents → agents}/research/learnings-researcher.md +0 -0
- /package/src/{.agents/agents → agents}/research/repo-research-analyst.md +0 -0
- /package/src/{.agents/agents → agents}/review/agent-native-reviewer.md +0 -0
- /package/src/{.agents/agents → agents}/review/planning-technical-reviewer.md +0 -0
- /package/src/{.agents/agents → agents}/workflow/bug-reproduction-validator.md +0 -0
- /package/src/{.agents/agents → agents}/workflow/lint.md +0 -0
- /package/src/{.agents/agents → agents}/workflow/spec-flow-analyzer.md +0 -0
- /package/src/{.agents/commands → commands}/test-browser.md +0 -0
- /package/src/{.agents/commands → commands}/workflow-brainstorm.md +0 -0
- /package/src/{.agents/commands → commands}/workflow-review.md +0 -0
- /package/src/{.agents/commands → commands}/workflow-tech-review.md +0 -0
- /package/src/{.agents/commands → commands}/workflow-triage.md +0 -0
- /package/src/{.agents/references → references}/standards/README.md +0 -0
- /package/src/{.agents/skills → skills}/agent-browser/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/audit-traceability/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/brainstorming/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/compound-docs/assets/critical-pattern-template.md +0 -0
- /package/src/{.agents/skills → skills}/compound-docs/assets/resolution-template.md +0 -0
- /package/src/{.agents/skills → skills}/compound-docs/schema.project.yaml +0 -0
- /package/src/{.agents/skills → skills}/compound-docs/schema.yaml +0 -0
- /package/src/{.agents/skills → skills}/data-foundations/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/document-review/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/file-todos/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/file-todos/assets/todo-template.md +0 -0
- /package/src/{.agents/skills → skills}/financial-workflow-integrity/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/git-worktree/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/pii-protection-prisma/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/process-metrics/SKILL.md +0 -0
- /package/src/{.agents/skills → skills}/process-metrics/assets/daily-template.md +0 -0
- /package/src/{.agents/skills → skills}/process-metrics/assets/monthly-template.md +0 -0
- /package/src/{.agents/skills → skills}/process-metrics/assets/weekly-template.md +0 -0
- /package/src/{.agents/skills → skills}/technical-review/SKILL.md +0 -0
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: react-ddd-mvc-frontend
|
|
3
|
-
description: Apply React frontend architecture standards using a DDD + MVC hybrid. Use when planning or reviewing frontend work to enforce domain-based feature structure, clear layer boundaries, composable pure components, container-driven composition, and XState controller integration.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# React DDD + MVC Frontend Standards
|
|
7
|
-
|
|
8
|
-
Use this skill as a reference standard during brainstorming, planning, implementation, and code review for frontend work.
|
|
9
|
-
|
|
10
|
-
## Workflow
|
|
11
|
-
|
|
12
|
-
1. Confirm frontend applicability.
|
|
13
|
-
- Use this skill when work changes React UI architecture, feature structure, components, containers, hooks, services, or controller state flow.
|
|
14
|
-
- Skip when no frontend surface is affected.
|
|
15
|
-
|
|
16
|
-
2. Load standards baseline.
|
|
17
|
-
- Start with [references/source-map.md](references/source-map.md).
|
|
18
|
-
- Load [references/feature-structure.md](references/feature-structure.md) and [references/responsibility-gates.md](references/responsibility-gates.md) first.
|
|
19
|
-
|
|
20
|
-
3. Enforce feature-by-domain structure.
|
|
21
|
-
- Group items into domains.
|
|
22
|
-
- Default location: `src/features/<feature-name>/`.
|
|
23
|
-
- Allow shared concerns under `src/features/common/` only when genuinely cross-domain.
|
|
24
|
-
|
|
25
|
-
4. Enforce DDD + MVC boundaries.
|
|
26
|
-
- Keep domain entities in `domain/entities`.
|
|
27
|
-
- Keep presentation concerns in `presentation`.
|
|
28
|
-
- Keep orchestration and composition in `application`.
|
|
29
|
-
- Keep IO adapters in `infrastructure`.
|
|
30
|
-
|
|
31
|
-
5. Apply controller/machine guidance.
|
|
32
|
-
- Controllers are XState machines in `application/controller`.
|
|
33
|
-
- For XState orchestration patterns, defer to `xstate-actor-orchestration`.
|
|
34
|
-
|
|
35
|
-
6. Apply coding style constraints.
|
|
36
|
-
- Prefer immutability and functional patterns.
|
|
37
|
-
- Apply YAGNI to avoid speculative abstractions.
|
|
38
|
-
- Optimize for simplicity, maintainability, and readability.
|
|
39
|
-
|
|
40
|
-
## Output Contract
|
|
41
|
-
|
|
42
|
-
When used in planning:
|
|
43
|
-
- Use applicable MUST gates as a checklist to shape acceptance criteria.
|
|
44
|
-
- Call out any boundary exceptions and rationale.
|
|
45
|
-
|
|
46
|
-
When used in review:
|
|
47
|
-
- Report MUST violations as high-priority findings by default.
|
|
48
|
-
- Report SHOULD violations as improvement findings.
|
|
49
|
-
|
|
50
|
-
When used in brainstorm/work:
|
|
51
|
-
- Use the structure and gates as reference guidance, not as a hard precondition.
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# Feature Structure (DDD + MVC Hybrid)
|
|
2
|
-
|
|
3
|
-
Default structure for each frontend feature:
|
|
4
|
-
|
|
5
|
-
```text
|
|
6
|
-
src/features/<feature-name>/
|
|
7
|
-
application/
|
|
8
|
-
containers/
|
|
9
|
-
controller/
|
|
10
|
-
domain/
|
|
11
|
-
entities/
|
|
12
|
-
presentation/
|
|
13
|
-
components/
|
|
14
|
-
layout/
|
|
15
|
-
infrastructure/
|
|
16
|
-
services/
|
|
17
|
-
mock-services/
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
## Notes
|
|
21
|
-
|
|
22
|
-
- Group work by domain.
|
|
23
|
-
- Use `src/features/common/` only for cross-domain shared concerns.
|
|
24
|
-
- Keep the shape consistent across features unless there is a clear, documented reason to deviate.
|
|
25
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# Implementation Principles
|
|
2
|
-
|
|
3
|
-
## Hooks
|
|
4
|
-
|
|
5
|
-
- Use hooks to provide common access patterns and shared feature wiring.
|
|
6
|
-
- Keep hooks focused and reusable; avoid mixing unrelated responsibilities.
|
|
7
|
-
|
|
8
|
-
## Immutability and Functional Style
|
|
9
|
-
|
|
10
|
-
- Prefer immutable updates and pure transformations.
|
|
11
|
-
- Avoid hidden in-place mutation across layers.
|
|
12
|
-
|
|
13
|
-
## Simplicity (YAGNI)
|
|
14
|
-
|
|
15
|
-
- Do not add speculative abstractions or layers before they are needed.
|
|
16
|
-
- Optimize for readability and maintainability over cleverness.
|
|
17
|
-
|
|
18
|
-
## Boundary Reminder
|
|
19
|
-
|
|
20
|
-
- If a change requires complex machine orchestration, use `xstate-actor-orchestration` as the source of truth for machine patterns.
|
|
21
|
-
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
# Responsibility Gates
|
|
2
|
-
|
|
3
|
-
Apply these gates as default guidance in planning and review.
|
|
4
|
-
Use pragmatic judgment and allow justified deviations when context requires.
|
|
5
|
-
|
|
6
|
-
## MUST Gates
|
|
7
|
-
|
|
8
|
-
1. Feature placement:
|
|
9
|
-
- Frontend feature code is placed in `src/features/<feature-name>/` using the canonical layer layout.
|
|
10
|
-
|
|
11
|
-
2. Presentation purity:
|
|
12
|
-
- `presentation/components` remain composable and controlled/pure.
|
|
13
|
-
- UI components do not perform API calls or domain decision logic.
|
|
14
|
-
|
|
15
|
-
3. Container ownership:
|
|
16
|
-
- `application/containers` own composition, state wiring, translations, and context wiring.
|
|
17
|
-
|
|
18
|
-
4. Controller ownership:
|
|
19
|
-
- `application/controller` contains XState machine controllers for feature state flow.
|
|
20
|
-
- Any advanced orchestration patterns defer to `xstate-actor-orchestration`.
|
|
21
|
-
|
|
22
|
-
5. Domain isolation:
|
|
23
|
-
- `domain/entities` owns domain entities and related core domain representation.
|
|
24
|
-
|
|
25
|
-
6. Infrastructure isolation:
|
|
26
|
-
- `infrastructure/services` and `infrastructure/mock-services` own IO integrations and test/mock adapters.
|
|
27
|
-
|
|
28
|
-
## SHOULD Gates
|
|
29
|
-
|
|
30
|
-
1. Reuse hooks for common access patterns instead of duplicating wiring logic.
|
|
31
|
-
2. Keep files single-purpose and avoid multi-layer mixing in one module.
|
|
32
|
-
3. Keep naming consistent with feature and domain language.
|
|
33
|
-
|
|
34
|
-
## Planning Gate
|
|
35
|
-
|
|
36
|
-
- Use applicable MUST gates to inform acceptance criteria.
|
|
37
|
-
|
|
38
|
-
## Review Gate
|
|
39
|
-
|
|
40
|
-
- MUST violations are high-priority by default.
|
|
41
|
-
- SHOULD violations are non-blocking unless repeated patterns create maintainability risk.
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
# Source Map
|
|
2
|
-
|
|
3
|
-
Load these references as needed:
|
|
4
|
-
|
|
5
|
-
- Feature folder and canonical layout:
|
|
6
|
-
- [feature-structure.md](feature-structure.md)
|
|
7
|
-
- Layer responsibilities and review gates:
|
|
8
|
-
- [responsibility-gates.md](responsibility-gates.md)
|
|
9
|
-
- Hooks, immutability, and simplicity rules:
|
|
10
|
-
- [implementation-principles.md](implementation-principles.md)
|
|
11
|
-
|