@llipe.com/dev-tasks 0.7.4 → 0.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/.claude/agents/developer.md +20 -10
- package/.claude/agents/qa-engineer.md +104 -0
- package/.claude/agents/verifier.md +1 -1
- package/.claude/commands/developer.md +14 -10
- package/.claude/commands/planner.md +10 -8
- package/.claude/commands/qa-engineer.md +23 -0
- package/.claude/skills/activity-coverage-gap-analysis/SKILL.md +107 -0
- package/.claude/skills/activity-test-implementation/SKILL.md +109 -0
- package/.claude/skills/activity-test-standards/SKILL.md +122 -0
- package/.claude/skills/implement/SKILL.md +19 -13
- package/.github/agents/developer.agent.md +20 -10
- package/.github/agents/planner.agent.md +10 -8
- package/.github/agents/qa-engineer.agent.md +104 -0
- package/.github/agents/verifier.agent.md +1 -1
- package/.github/instructions/implement.instructions.md +19 -13
- package/.github/prompts/qa-engineer.prompt.md +23 -0
- package/.github/skills/activity-coverage-gap-analysis/SKILL.md +107 -0
- package/.github/skills/activity-test-implementation/SKILL.md +109 -0
- package/.github/skills/activity-test-standards/SKILL.md +122 -0
- package/.kiro/agents/developer.md +27 -11
- package/.kiro/agents/github-ops.md +2 -0
- package/.kiro/agents/housekeeping.md +3 -0
- package/.kiro/agents/planner.md +17 -9
- package/.kiro/agents/product-engineer.md +9 -1
- package/.kiro/agents/qa-engineer.md +108 -0
- package/.kiro/agents/technical-writer.md +4 -0
- package/.kiro/agents/ux-engineer.md +4 -0
- package/.kiro/agents/verifier.md +5 -1
- package/.kiro/hooks/git-guard.json +12 -1
- package/.kiro/hooks/scripts/branch-guard.sh +36 -0
- package/.kiro/skills/activity-coverage-gap-analysis/SKILL.md +107 -0
- package/.kiro/skills/activity-test-implementation/SKILL.md +109 -0
- package/.kiro/skills/activity-test-standards/SKILL.md +122 -0
- package/.kiro/steering/implement.md +23 -13
- package/AGENTS.md +102 -23
- package/CHANGELOG.md +70 -0
- package/CLAUDE.md +6 -3
- package/README.md +108 -112
- package/bundle-manifest.json +1 -0
- package/dist/core/distribution/install.d.ts.map +1 -1
- package/dist/core/distribution/install.js +25 -2
- package/dist/core/distribution/install.js.map +1 -1
- package/dist/core/distribution/profiles.d.ts +21 -0
- package/dist/core/distribution/profiles.d.ts.map +1 -1
- package/dist/core/distribution/profiles.js +21 -0
- package/dist/core/distribution/profiles.js.map +1 -1
- package/dist/core/extract/asyncapi/declared.d.ts +19 -0
- package/dist/core/extract/asyncapi/declared.d.ts.map +1 -0
- package/dist/core/extract/asyncapi/declared.js +168 -0
- package/dist/core/extract/asyncapi/declared.js.map +1 -0
- package/dist/core/extract/asyncapi/index.d.ts +1 -0
- package/dist/core/extract/asyncapi/index.d.ts.map +1 -1
- package/dist/core/extract/asyncapi/index.js +1 -0
- package/dist/core/extract/asyncapi/index.js.map +1 -1
- package/dist/core/extract/asyncapi/types.d.ts +1 -1
- package/dist/core/extract/asyncapi/types.d.ts.map +1 -1
- package/dist/core/extract/ladder.d.ts +79 -0
- package/dist/core/extract/ladder.d.ts.map +1 -0
- package/dist/core/extract/ladder.js +70 -0
- package/dist/core/extract/ladder.js.map +1 -0
- package/dist/core/extract/openapi/index.d.ts +35 -5
- package/dist/core/extract/openapi/index.d.ts.map +1 -1
- package/dist/core/extract/openapi/index.js +136 -3
- package/dist/core/extract/openapi/index.js.map +1 -1
- package/dist/core/extract/openapi/route2-introspect.d.ts +18 -0
- package/dist/core/extract/openapi/route2-introspect.d.ts.map +1 -0
- package/dist/core/extract/openapi/route2-introspect.js +249 -0
- package/dist/core/extract/openapi/route2-introspect.js.map +1 -0
- package/dist/core/extract/openapi/route2.d.ts +40 -17
- package/dist/core/extract/openapi/route2.d.ts.map +1 -1
- package/dist/core/extract/openapi/route2.js +202 -10
- package/dist/core/extract/openapi/route2.js.map +1 -1
- package/dist/core/extract/openapi/types.d.ts +3 -3
- package/dist/core/extract/openapi/types.d.ts.map +1 -1
- package/dist/core/extract/provider.d.ts +4 -0
- package/dist/core/extract/provider.d.ts.map +1 -1
- package/dist/core/extract/report.d.ts +29 -1
- package/dist/core/extract/report.d.ts.map +1 -1
- package/dist/core/extract/report.js +7 -2
- package/dist/core/extract/report.js.map +1 -1
- package/dist/core/extract/schema.d.ts +16 -18
- package/dist/core/extract/schema.d.ts.map +1 -1
- package/dist/core/extract/schema.js +48 -43
- package/dist/core/extract/schema.js.map +1 -1
- package/dist/core/extract/workspaces.d.ts +33 -0
- package/dist/core/extract/workspaces.d.ts.map +1 -0
- package/dist/core/extract/workspaces.js +193 -0
- package/dist/core/extract/workspaces.js.map +1 -0
- package/package.json +10 -2
- package/dist/core/extract/openapi/llm-descriptions.d.ts +0 -41
- package/dist/core/extract/openapi/llm-descriptions.d.ts.map +0 -1
- package/dist/core/extract/openapi/llm-descriptions.js +0 -36
- package/dist/core/extract/openapi/llm-descriptions.js.map +0 -1
- package/dist/core/extract/orm/llm-descriptions.d.ts +0 -28
- package/dist/core/extract/orm/llm-descriptions.d.ts.map +0 -1
- package/dist/core/extract/orm/llm-descriptions.js +0 -64
- package/dist/core/extract/orm/llm-descriptions.js.map +0 -1
- package/dist/core/extract/orm/migration-inference.d.ts +0 -25
- package/dist/core/extract/orm/migration-inference.d.ts.map +0 -1
- package/dist/core/extract/orm/migration-inference.js +0 -76
- package/dist/core/extract/orm/migration-inference.js.map +0 -1
package/AGENTS.md
CHANGED
|
@@ -27,6 +27,19 @@ If `/DESIGN.md` is missing and the requested scope includes UI work, agents **MU
|
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
30
|
+
## Testing Standard Contract (TESTING.md)
|
|
31
|
+
|
|
32
|
+
`/TESTING.md` is the canonical testing contract for a repository. It declares the layer taxonomy and what belongs at each layer, the per-package runner and commands, coverage thresholds and baseline policy, the fixture and mocking strategy, and the mandatory security-negative cases.
|
|
33
|
+
|
|
34
|
+
- `qa-engineer` **OWNS** `/TESTING.md` and fills it per project via `activity-test-standards`.
|
|
35
|
+
- `developer` **MUST** keep it current when the testing contract changes.
|
|
36
|
+
- Agents that read it **MUST** treat an unfilled placeholder as "no standard established", never as permission.
|
|
37
|
+
- The contract is **per-package**: a repository mixing languages (for example vitest and pytest) **MUST** be describable without forcing every package into one language's script names.
|
|
38
|
+
|
|
39
|
+
It ships with dev-tasks as a placeholder and is listed in `consumer_owned_paths`, so `dev-tasks update` never overwrites a filled version.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
30
43
|
## Taxonomy: Agent vs Skill vs Instruction
|
|
31
44
|
|
|
32
45
|
| Concept | Purpose | Loaded When |
|
|
@@ -48,26 +61,32 @@ If `/DESIGN.md` is missing and the requested scope includes UI work, agents **MU
|
|
|
48
61
|
| **housekeeping** | `housekeeping.agent.md` | Lint, type, and test-wiring fixes |
|
|
49
62
|
| **github-ops** | `github-ops.agent.md` | GitHub consistency — standardizes issues, PRs, branches, labels, milestones, comments, and enforces merge authority policy |
|
|
50
63
|
| **ux-engineer** | `ux-engineer.agent.md` | UX prototyping and gap analysis — turns PRD/SPEC into testable mockups and feeds refinements back to `product-engineer` |
|
|
64
|
+
| **qa-engineer** | `qa-engineer.agent.md` | Quality agent — establishes the `/TESTING.md` standard, authors tests for layers the project lacks, and reports coverage and structural gaps. Invoked by `developer` at the completion gate, before the `verifier` audit |
|
|
51
65
|
| **verifier** | `verifier.agent.md` | Verification agent — owns compliance test-plan design (`design` mode) and post-implementation grey-box fidelity auditing (`audit` mode) against codebase, `/workstream`, tests, and PRD/spec intent |
|
|
52
66
|
|
|
67
|
+
`.github/agents/` and `.kiro/agents/` carry all nine agents. `.claude/agents/` carries seven by design: `planner` and `product-engineer` are orchestrators that must pause for user-approval gates, so on Claude Code they run in the main thread as `.claude/commands/` entry points rather than as subagents. See `CLAUDE.md`.
|
|
68
|
+
|
|
53
69
|
## Skills
|
|
54
70
|
|
|
55
71
|
Skills are on-demand capabilities invoked by agents — **not** loaded unless explicitly referenced.
|
|
56
72
|
|
|
57
73
|
### Activity Skills
|
|
58
74
|
|
|
59
|
-
| Skill
|
|
60
|
-
|
|
|
61
|
-
| **activity-init**
|
|
62
|
-
| **activity-refine**
|
|
63
|
-
| **activity-generate-spec**
|
|
64
|
-
| **activity-generate-stories**
|
|
65
|
-
| **activity-publish-github**
|
|
66
|
-
| **activity-e2e-test-design**
|
|
67
|
-
| **activity-contract-test-design**
|
|
68
|
-
| **activity-edge-case-refinement**
|
|
69
|
-
| **activity-random-test-tactics**
|
|
70
|
-
| **activity-
|
|
75
|
+
| Skill | Directory | Purpose | Primary Consumer |
|
|
76
|
+
| ---------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
|
|
77
|
+
| **activity-init** | `skills/activity-init/` | Establish product context and technical guidelines (mono/multi-repo/greenfield mode detection) | `product-engineer` |
|
|
78
|
+
| **activity-refine** | `skills/activity-refine/` | Clarify scope — issue refinement or full PRD creation | `product-engineer` |
|
|
79
|
+
| **activity-generate-spec** | `skills/activity-generate-spec/` | Transform PRD into technical specification | `product-engineer` |
|
|
80
|
+
| **activity-generate-stories** | `skills/activity-generate-stories/` | Break spec into user stories with coverage validation | `product-engineer` |
|
|
81
|
+
| **activity-publish-github** | `skills/activity-publish-github/` | Publish stories as GitHub Issues via MCP | `product-engineer` |
|
|
82
|
+
| **activity-e2e-test-design** | `skills/activity-e2e-test-design/` | End-to-end black-box test scenario generation from spec/stories | `verifier` |
|
|
83
|
+
| **activity-contract-test-design** | `skills/activity-contract-test-design/` | Consumer/provider contract and schema compatibility test strategy | `verifier` |
|
|
84
|
+
| **activity-edge-case-refinement** | `skills/activity-edge-case-refinement/` | Systematic edge-case discovery by category with concrete examples | `verifier` |
|
|
85
|
+
| **activity-random-test-tactics** | `skills/activity-random-test-tactics/` | Randomized, fuzz, and property-inspired test generation with reproducibility | `verifier` |
|
|
86
|
+
| **activity-test-standards** | `skills/activity-test-standards/` | Establish and maintain `/TESTING.md`, detect harness defects, verify test-script and CI/deploy gate reachability | `qa-engineer` |
|
|
87
|
+
| **activity-test-implementation** | `skills/activity-test-implementation/` | Author Layer 1-2 tests with enforceable boundaries and a mandatory security-negative category | `qa-engineer` |
|
|
88
|
+
| **activity-coverage-gap-analysis** | `skills/activity-coverage-gap-analysis/` | Measure coverage against a baseline, or run risk-ranked structural gap analysis when no provider exists | `qa-engineer` |
|
|
89
|
+
| **activity-drift-reconciliation** | `skills/activity-drift-reconciliation/` | Routes verifier drift findings into task-list/checklist expansion, new issues, or PRD/spec changelog write-back (human-confirmed) | `product-engineer` |
|
|
71
90
|
|
|
72
91
|
### Operational Skills
|
|
73
92
|
|
|
@@ -79,20 +98,27 @@ Skills are on-demand capabilities invoked by agents — **not** loaded unless ex
|
|
|
79
98
|
|
|
80
99
|
### Third-Party Skills
|
|
81
100
|
|
|
82
|
-
|
|
83
|
-
| ------------------------------- | ------------------------------------- | ------------------------------------- | -------------------------- |
|
|
84
|
-
| **vercel-composition-patterns** | `skills/vercel-composition-patterns/` | Vercel component composition patterns | `developer`, `ux-engineer` |
|
|
85
|
-
| **vercel-react-best-practices** | `skills/vercel-react-best-practices/` | Vercel React best practices | `developer`, `ux-engineer` |
|
|
101
|
+
None currently vendored. Third-party skills, when added, are installed under each platform's skills directory alongside the skills above.
|
|
86
102
|
|
|
87
103
|
## Instructions (Scoped)
|
|
88
104
|
|
|
89
|
-
Instructions are scoped via `applyTo`/`fileMatchPattern` and auto-applied to matching files.
|
|
105
|
+
Instructions are scoped via `applyTo`/`fileMatchPattern` and auto-applied to matching files. Claude Code has no scoped-instruction mechanism, so `plan` and `implement` ship there as skills instead.
|
|
90
106
|
|
|
91
|
-
| Instruction |
|
|
92
|
-
| --------------------------- |
|
|
93
|
-
| **plan** |
|
|
94
|
-
| **implement** |
|
|
95
|
-
| **nextjs-pages-components** |
|
|
107
|
+
| Instruction | Copilot / Kiro file | Claude equivalent | Scope | Purpose |
|
|
108
|
+
| --------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
109
|
+
| **plan** | `.github/instructions/plan.instructions.md` / `.kiro/steering/plan.md` | `.claude/skills/plan/` | `workstream/**` | Convert stories or refined issues into execution-ready task lists |
|
|
110
|
+
| **implement** | `.github/instructions/implement.instructions.md` / `.kiro/steering/implement.md` | `.claude/skills/implement/` | `workstream/**/tasks-*.md` | Execute task list with step-gated approval, branching, and PR discipline |
|
|
111
|
+
| **nextjs-pages-components** | `.github/instructions/domain/nextjs-pages-components.instructions.md` / `.kiro/steering/nextjs-pages-components.md` | — | `**/app/**/*.tsx` | Next.js + React conventions |
|
|
112
|
+
| **git-guard-notice** | `.kiro/steering/git-guard-notice.md` | — | Always loaded (Kiro) | Restates the three git invariants: no push/merge to `main`, Conventional Commits, `--body-file` for `gh` bodies |
|
|
113
|
+
|
|
114
|
+
## Hooks
|
|
115
|
+
|
|
116
|
+
| Hook | Files | Purpose |
|
|
117
|
+
| ---------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
|
118
|
+
| **git-guard** | `.kiro/hooks/git-guard.json`, `.kiro/hooks/scripts/git-guard.sh`, `.claude/hooks/git-guard.sh` | Blocks pushes/merges to `main`, non-Conventional commit messages, and inline `gh --body` |
|
|
119
|
+
| **branch-guard** | `.kiro/hooks/scripts/branch-guard.sh` | Blocks write operations while on the default branch |
|
|
120
|
+
|
|
121
|
+
Hook enforcement is best-effort. Human PR review is the actual gate for these invariants.
|
|
96
122
|
|
|
97
123
|
## Prompts
|
|
98
124
|
|
|
@@ -100,6 +126,58 @@ See individual agent files for invocation modes and entry points. Reference: Cop
|
|
|
100
126
|
|
|
101
127
|
---
|
|
102
128
|
|
|
129
|
+
## Agent File Format (Kiro Custom Agents)
|
|
130
|
+
|
|
131
|
+
Agent files in `.kiro/agents/` use YAML frontmatter followed by a markdown body containing the system prompt. The frontmatter conforms to the [official Kiro custom agent configuration reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/).
|
|
132
|
+
|
|
133
|
+
### Frontmatter Schema
|
|
134
|
+
|
|
135
|
+
```yaml
|
|
136
|
+
---
|
|
137
|
+
description: "<human-readable agent description>"
|
|
138
|
+
tools: [<tool-tags>] # Allowed: read, write, shell, web
|
|
139
|
+
resources: # Context files auto-loaded into the agent
|
|
140
|
+
- file://<relative-path> # Project files (e.g., file://AGENTS.md)
|
|
141
|
+
- skill://<glob-pattern> # Skill definitions (e.g., skill://.kiro/skills/**/SKILL.md)
|
|
142
|
+
permissions: # (Optional) Fine-grained access control
|
|
143
|
+
- allow: <action>
|
|
144
|
+
paths: ["<glob>"]
|
|
145
|
+
- deny: <action>
|
|
146
|
+
paths: ["<glob>"]
|
|
147
|
+
---
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### Field Reference
|
|
151
|
+
|
|
152
|
+
| Field | Required | Description |
|
|
153
|
+
| -------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
154
|
+
| `description` | Yes | Human-readable purpose. Used by the runtime for agent selection and routing. |
|
|
155
|
+
| `tools` | Yes | Tag-based tool categories: `read`, `write`, `shell`, `web`. Use `["*"]` for unrestricted. |
|
|
156
|
+
| `resources` | No | Context files auto-loaded via `file://` (project files) and `skill://` (skill definitions). |
|
|
157
|
+
| `permissions` | No | Inline permission rules for fine-grained access control (allow/deny by path glob). **Note:** Not yet supported by the Kiro runtime as of v1.0 — presence causes agents to fail to load. |
|
|
158
|
+
| `model` | No | Model selection override (omit to use the runtime default). |
|
|
159
|
+
| `mcpServers` | No | Embedded MCP server configurations for tool extensions. |
|
|
160
|
+
| `allowedTools` | No | Tools that execute without prompting (pre-approved). |
|
|
161
|
+
|
|
162
|
+
### Tool Categories
|
|
163
|
+
|
|
164
|
+
| Tag | Grants Access To |
|
|
165
|
+
| ------- | ------------------------------------- |
|
|
166
|
+
| `read` | File reading, search, code navigation |
|
|
167
|
+
| `write` | File creation, editing, deletion |
|
|
168
|
+
| `shell` | Terminal command execution |
|
|
169
|
+
| `web` | Web browsing and HTTP requests |
|
|
170
|
+
|
|
171
|
+
> **Note:** `subagent` is not an official tool category. Subagent delegation is a runtime capability, not a tool permission.
|
|
172
|
+
|
|
173
|
+
### References
|
|
174
|
+
|
|
175
|
+
- [Kiro Custom Agent Configuration Reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/)
|
|
176
|
+
- [Kiro CLI v3 Agent Config](https://kiro.dev/docs/cli/v3/agent-config/)
|
|
177
|
+
- [Sample Multi-Agent Repository](https://github.com/aws-samples/sample-kiro-cli-multiagent-development)
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
103
181
|
## General Agent Guidelines
|
|
104
182
|
|
|
105
183
|
All AI coding agents working in this repository **MUST**:
|
|
@@ -115,6 +193,7 @@ All AI coding agents working in this repository **MUST**:
|
|
|
115
193
|
- Use canonical script names: `lint`, `format:check`, `typecheck`, `test`, `audit`, `validate`
|
|
116
194
|
- Enforce quality gates before completion: `test`, `lint`, `format:check`, `typecheck`, `audit`
|
|
117
195
|
- Use the `git-ops` skill for branch management, rebase, and conflict resolution
|
|
196
|
+
- `qa-engineer` runs at the completion gate, before the `verifier` audit, and records `coverage_gate`. It **MAY** be skipped only as `SKIPPED(<reason>)` with a non-empty reason; omitting the field is treated as incomplete.
|
|
118
197
|
- The `verifier` audit is mandatory and non-skippable before every PR is marked ready. Drift findings are non-blocking and route to `product-engineer`'s `activity-drift-reconciliation`.
|
|
119
198
|
- **Test-first design is the default:** `product-engineer` recommends `verifier` Design Mode after planning; `developer` writes tests before implementation code; `planner` checks for test plans and enforces test-first in developer handoffs
|
|
120
199
|
- If `memo-cli` is installed and configured: agents **MUST** read/write entries per their role (see agent files for details)
|
|
@@ -214,4 +293,4 @@ When `scope.primary` contains exactly 1 component, no partitioning is needed. Th
|
|
|
214
293
|
|
|
215
294
|
---
|
|
216
295
|
|
|
217
|
-
For workflow chains and sequencing diagrams, see [`docs/workflow-chains.md`](docs/workflow-chains.md).
|
|
296
|
+
For workflow chains and sequencing diagrams, see [`docs/workflow-chains.md`](docs/workflow-chains.md). For architecture, artifacts, and invariants, see [`docs/system-overview.md`](docs/system-overview.md) and [`docs/data-model.md`](docs/data-model.md). Full documentation index: [`docs/README.md`](docs/README.md).
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,75 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
7
7
|
|
|
8
|
+
## [0.9.0] - 2026-08-18
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- feat(qa): wire TESTING.md distribution and update all registries
|
|
13
|
+
- feat(qa): wire qa-engineer into developer, planner, implement, verifier
|
|
14
|
+
- feat(qa): add three testing skills mirrored across platforms
|
|
15
|
+
- feat(qa): add TESTING.md contract and qa-engineer agent
|
|
16
|
+
- feat(extract): wire schema extraction through ladder (declared → observed)
|
|
17
|
+
- feat(extract): add pg as optional peer dep, update Known Limitations
|
|
18
|
+
- feat(extract): add AsyncAPI declared rung for on-disk spec detection
|
|
19
|
+
- feat(extract): add OpenAPI ladder orchestrator (declared → observed → inferred)
|
|
20
|
+
- feat(extract): remove in-CLI LLM, extend report with provenance and handoff
|
|
21
|
+
- feat(extract): add workspace discovery and ladder runner
|
|
22
|
+
- feat(extract): implement route2 spike — boot + introspect for Express
|
|
23
|
+
|
|
24
|
+
### Fixed
|
|
25
|
+
|
|
26
|
+
- fix: format
|
|
27
|
+
- fix(qa): address Major audit findings D-1 and D-2
|
|
28
|
+
- fix(workflow): open draft PR after first commit, not before
|
|
29
|
+
|
|
30
|
+
### Changed
|
|
31
|
+
|
|
32
|
+
- Merge pull request #129 from llipe:issue/123-qa-agent-and-testing-standard
|
|
33
|
+
- docs(qa): sync registries, guidelines, and ADR-003 for the coverage gate
|
|
34
|
+
- test(qa): add fixture projects reproducing the home-ledger defects
|
|
35
|
+
- test(dist): add failing root-file distribution assertions for TESTING.md
|
|
36
|
+
- test(qa): add failing testing-standard assertions and rule-19 guard
|
|
37
|
+
- test(qa): add failing qa-engineer parity and prompt-cap assertions
|
|
38
|
+
- Merge pull request #128 from llipe/docs/current-state-sync-post-125
|
|
39
|
+
- chore(workstream): reorganize docs into archive directory
|
|
40
|
+
- docs: sync documentation with current dt implementation state
|
|
41
|
+
- Merge pull request #125 from llipe:claude/dev-tasks-codebase-analysis-oxda22
|
|
42
|
+
- chore: resolve merge conflict with main in catalog index.yaml
|
|
43
|
+
- docs(workstream): fix manual test plan — scripts must run from project root
|
|
44
|
+
- docs(workstream): fix manual test plan — scripts must run from project root
|
|
45
|
+
- docs(workstream): rewrite manual test plan with proper tsx file approach
|
|
46
|
+
- docs(workstream): fix manual test plan for tsx top-level await limitation
|
|
47
|
+
- chore: fix lint and format issues, update task checklist
|
|
48
|
+
- chore(workstream): link task list to issue #127 and PR #125
|
|
49
|
+
- Merge pull request #126 from llipe:issue/docs-current-state-sync
|
|
50
|
+
- docs: reorganize and document system architecture and agent framework
|
|
51
|
+
- chore(workstream): add task list for extraction ladder inversion plan
|
|
52
|
+
|
|
53
|
+
## [0.8.0] - 2026-08-11
|
|
54
|
+
|
|
55
|
+
### Fixed
|
|
56
|
+
|
|
57
|
+
- fix(hooks): update git-guard matcher and add branch-guard for write tools (issue #110, task 5.0)
|
|
58
|
+
- fix(agent): add branch/PR to per-turn output contract (issue #110, task 4.0)
|
|
59
|
+
- fix(agent): harden branch creation gate across all platforms (issue #110, task 3.0)
|
|
60
|
+
- fix(agent): add subagent tool to developer agent (issue #110, task 1.0)
|
|
61
|
+
- fix: remove unsupported permissions field from agent frontmatter
|
|
62
|
+
|
|
63
|
+
### Changed
|
|
64
|
+
|
|
65
|
+
- chore: format corrections
|
|
66
|
+
- chore: doc archiving
|
|
67
|
+
- Merge pull request #120 from llipe:issue/110-developer-branch-creation
|
|
68
|
+
- chore(workstream): mark all tasks complete for issue #110
|
|
69
|
+
- docs(steering): document fileMatchPattern glob behavior for zero-depth (issue #110, task 2.0)
|
|
70
|
+
- chore(workstream): activate task list for issue #110
|
|
71
|
+
- chore: docs housekeeping
|
|
72
|
+
- Merge pull request #119 from llipe:issue/103-kiro-agent-format
|
|
73
|
+
- chore: update catalog fixture timestamps and generator version
|
|
74
|
+
- docs: note permissions field is unsupported in current Kiro runtime
|
|
75
|
+
- chore: adapt .kiro/agents to official Kiro custom agent format
|
|
76
|
+
|
|
8
77
|
## [0.7.4] - 2026-08-07
|
|
9
78
|
|
|
10
79
|
### Changed
|
|
@@ -55,6 +124,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
|
55
124
|
- feat(catalog): implement catalog query and routing commands (S-013) Implements dt catalog resolve, get, deps, consumers, flow, closure, and coverage subcommands with full --json support. - core/catalog/resolve.ts: text normalization (lowercase, de-accent, light es/en stemming, stopword removal) and weighted lexical scorer (exact id 100, alias 80, flow alias 75, domain 60, alias-token 40, name/desc 25) - core/catalog/queries.ts: graph reads (get, deps with depth/direction, consumers, flow, closure with include-consumers/max cap) - core/catalog/coverage.ts: extraction quality aggregation per component - adapters/cli/catalog-query.ts: CLI handler for all query subcommands - FlowEntry model extended with optional aliases field - Flow fixture files updated with aliases for routing tests Refs #46
|
|
56
125
|
- feat(catalog): implement dt catalog validate with V01-V19 checks Implements referential integrity and structural validation checks per spec §6.2. Errors (V01-V11, V14-V15, V19) abort with exit 4; warnings (V12-V13, V16-V18) do not. Under --strict, V12 cycle warnings become errors. Supports allowed_cycles config. Closes #45
|
|
57
126
|
- feat(catalog): support component.yaml in addition to component.json Build now looks for component.json first, then falls back to component.yaml. This matches the spec's mention of component.yaml while preserving backward compat with JSON format.
|
|
127
|
+
- **Correction (2026-08-14):** this fallback was reverted within the same release (`7bebc79` reverting `f697265`) and was never shipped. The released behavior of 0.7.0 is `component.json` only; a repo carrying only `component.yaml` is reported in `index.errors[]`. See [`docs/adr/ADR-001-component-json-manifest-format.md`](docs/adr/ADR-001-component-json-manifest-format.md).
|
|
58
128
|
- feat(catalog): implement dt catalog build — aggregate manifests and generate index Implements Story S-011 (#43): - Define CatalogIndex types in core/catalog/index-model.ts - Implement registry parsing, manifest fetching, and mirroring - Build inverted consumer index from provides/consumes - Tally extraction quality from provenance fields - Aggregate domains and flows from manifests and catalog/flows/ - Generate deterministic catalog/index.yaml (sorted keys, stable order) - Implement idempotent write (skip when nothing changed) - Handle single repo failure: record in errors[], exit 3 - Detect duplicate component IDs across repos - Wire dt catalog build --registry <path> [--concurrency] [--json] CLI - Add 20-component fixture registry with diverse scenarios - Add yaml@2.7.1 dependency for YAML serialization Closes #43
|
|
59
129
|
- feat(catalog): add JSON Schemas and dt validate-component Adds component.schema.json, flow.schema.json, and scope-output.schema.json (JSON Schema draft 2020-12) plus a local validate-component module using ajv's Ajv2020 class. Wires dt validate-component <path> with human and --json output, exit 0/4. No network access required. Refs #42
|
|
60
130
|
|
package/CLAUDE.md
CHANGED
|
@@ -19,6 +19,8 @@ All work in this repository **MUST**:
|
|
|
19
19
|
- Prefer `pnpm` over `npm` for JavaScript/TypeScript workflows (fallback to `npm` only when `pnpm` is unavailable or explicitly disallowed).
|
|
20
20
|
- Use canonical `package.json` script names for JS/TS projects: `lint`, `lint:fix`, `format`, `format:check`, `typecheck`, `test`, `test:unit`, `test:integration`, `test:e2e`, `audit`, `validate`.
|
|
21
21
|
- Before developer/planner completion, enforce and record quality gates: `test`, `lint`, `format:check`, `typecheck`, `audit`.
|
|
22
|
+
- `qa-engineer` runs at the completion gate, before the `verifier` audit, and records `coverage_gate: PASS | FAIL | SKIPPED(<reason>)`. Skipping requires a non-empty reason; omitting the field is treated as incomplete.
|
|
23
|
+
- `/TESTING.md` is the canonical testing contract — owned by `qa-engineer`, kept current by `developer`, and treated as "no standard established" while unfilled.
|
|
22
24
|
- Reference GitHub Issues in branch names and commits; follow the `github-ops` conventions for all GitHub artifacts (issues, PRs, branches, labels, milestones, comments).
|
|
23
25
|
- Treat `/DESIGN.md` as the source of truth for visual tokens, components, and design guidance; update it whenever UI contracts change.
|
|
24
26
|
- Maintain document changelogs when updating generated artifacts (PRDs, specs, stories, refinements).
|
|
@@ -52,13 +54,14 @@ This toolkit is exposed as **commands** (entry points you invoke with `/`), **su
|
|
|
52
54
|
| `/github-ops` | Audit/standardize GitHub artifacts. |
|
|
53
55
|
| `/technical-writer` | Sync `/docs` with the codebase. |
|
|
54
56
|
| `/housekeeping` | Fix lint/type/test-wiring issues. |
|
|
57
|
+
| `/qa-engineer` | Establish `/TESTING.md`, author missing Layer 1-2 tests, and report `coverage_gate` plus risk-ranked gaps. |
|
|
55
58
|
| `/ux-engineer` | PRD/SPEC → React mockups + refinement handoff. |
|
|
56
59
|
| `/verifier-design` | Generate a compliance test plan + traceability matrix from a spec/story (Design Mode). |
|
|
57
60
|
| `/verifier-audit` | Grey-box fidelity audit of delivered work against requirements and PRD/spec intent (Audit Mode). |
|
|
58
61
|
|
|
59
62
|
### Subagents (`.claude/agents/`)
|
|
60
63
|
|
|
61
|
-
`developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
|
|
64
|
+
`developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier`, `qa-engineer` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
|
|
62
65
|
|
|
63
66
|
### Orchestration model (important)
|
|
64
67
|
|
|
@@ -69,9 +72,9 @@ Claude Code subagents **cannot spawn other subagents** — the hierarchy is flat
|
|
|
69
72
|
|
|
70
73
|
### Skills (`.claude/skills/`)
|
|
71
74
|
|
|
72
|
-
Activity skills: `activity-init`, `activity-refine`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-contract-test-design`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `webapp-mockup`, `memo-cli-usage`.
|
|
75
|
+
Activity skills: `activity-init`, `activity-refine`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-contract-test-design`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-test-standards`, `activity-test-implementation`, `activity-coverage-gap-analysis`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `webapp-mockup`, `memo-cli-usage`.
|
|
73
76
|
|
|
74
|
-
`plan` and `implement`
|
|
77
|
+
`plan` and `implement` are scoped instructions on Copilot (`applyTo`) and scoped steering on Kiro (`fileMatchPattern`); as Claude skills they load on demand instead of consuming context on every matching turn.
|
|
75
78
|
|
|
76
79
|
---
|
|
77
80
|
|