@arjunkhera/atlas 0.3.7 → 0.3.9
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-plugin/plugin.json +1 -1
- package/agents/artifact-renderer.md +22 -22
- package/agents/verifier.md +29 -0
- package/door/cli.mjs +62 -12
- package/door/kit-releases.json +4 -0
- package/door/lib/design-build.mjs +409 -0
- package/door/lib/design.mjs +199 -118
- package/door/lib/markdown.mjs +160 -0
- package/door/lib/proof.mjs +127 -0
- package/door/lib/tests.mjs +190 -0
- package/package.json +2 -1
- package/skills/lead/SKILL.md +4 -1
- package/skills/sdlc-task/SKILL.md +33 -24
- package/skills/sdlc-task/design/README.md +187 -0
- package/skills/sdlc-task/design/parts/actors.md +26 -0
- package/skills/sdlc-task/design/parts/alternatives.md +24 -0
- package/skills/sdlc-task/design/parts/build.md +23 -0
- package/skills/sdlc-task/design/parts/calls.md +25 -0
- package/skills/sdlc-task/design/parts/change.md +27 -0
- package/skills/sdlc-task/design/parts/data.md +22 -0
- package/skills/sdlc-task/design/parts/done.md +23 -0
- package/skills/sdlc-task/design/parts/edges.md +24 -0
- package/skills/sdlc-task/design/parts/goals.md +27 -0
- package/skills/sdlc-task/design/parts/key.md +25 -0
- package/skills/sdlc-task/design/parts/migration.md +22 -0
- package/skills/sdlc-task/design/parts/order.md +24 -0
- package/skills/sdlc-task/design/parts/problem.md +22 -0
- package/skills/sdlc-task/design/parts/proof.md +24 -0
- package/skills/sdlc-task/design/parts/proposal.md +24 -0
- package/skills/sdlc-task/design/parts/records.md +24 -0
- package/skills/sdlc-task/design/parts/repos.md +25 -0
- package/skills/sdlc-task/design/parts/risks.md +24 -0
- package/skills/sdlc-task/design/parts/rollout.md +24 -0
- package/skills/sdlc-task/design/parts/routes.md +24 -0
- package/skills/sdlc-task/design/parts/scorecard.md +25 -0
- package/skills/sdlc-task/design/parts/security.md +22 -0
- package/skills/sdlc-task/design/parts/shared-decisions.md +24 -0
- package/skills/sdlc-task/design/parts/states.md +25 -0
- package/skills/sdlc-task/design/parts/stories.md +26 -0
- package/skills/sdlc-task/design/parts/summary.md +33 -0
- package/skills/sdlc-task/design/parts/why.md +22 -0
- package/skills/sdlc-task/design/parts/words.md +29 -0
- package/skills/sdlc-task/design/parts/yardstick.md +25 -0
- package/skills/sdlc-task/design/parts.yaml +306 -0
- package/skills/sdlc-task/lifecycle.yaml +2 -2
- package/skills/tests/SKILL.md +234 -0
- package/tests/contract.mjs +398 -0
- package/tests/drivers/function.mjs +30 -0
- package/tests/drivers/http.mjs +68 -0
- package/tests/drivers/index.mjs +65 -0
- package/tests/drivers/mcp-stdio.mjs +174 -0
- package/tests/environment.mjs +227 -0
- package/tests/errors.mjs +27 -0
- package/tests/evidence.mjs +113 -0
- package/tests/fresh.mjs +42 -0
- package/tests/guards.mjs +159 -0
- package/tests/index.mjs +11 -0
- package/tests/link-check.mjs +576 -0
- package/tests/procs.mjs +43 -0
- package/tests/redact.mjs +58 -0
- package/tests/scenario.mjs +325 -0
- package/tests/stand-in.mjs +74 -0
- package/tests/tests-yaml.mjs +258 -0
- package/tests/wait.mjs +44 -0
- package/tests/yaml.mjs +327 -0
- package/agents/artifact-format/walkthrough.html +0 -706
- package/skills/sdlc-task/templates/design-doc.md +0 -126
|
@@ -1,126 +0,0 @@
|
|
|
1
|
-
# <Feature name> — design
|
|
2
|
-
|
|
3
|
-
> Status: DRAFT | APPROVED <date> | SHIPPED <date>
|
|
4
|
-
> Work item: <work item id> · Tier: standard | initiative
|
|
5
|
-
> Page: <artifact url once published>
|
|
6
|
-
|
|
7
|
-
*Write for a new joiner who knows nothing about this repo. Lead with the
|
|
8
|
-
idea, then show it. Run `atlas design` and `atlas ste` on this file
|
|
9
|
-
before you render it.*
|
|
10
|
-
|
|
11
|
-
## Summary
|
|
12
|
-
|
|
13
|
-
*At most two short paragraphs. Say what changes and why, in plain words.
|
|
14
|
-
Use no ids.*
|
|
15
|
-
|
|
16
|
-
## Part 1 — What and why
|
|
17
|
-
|
|
18
|
-
### Step 1 — <one idea, in a few words>
|
|
19
|
-
|
|
20
|
-
*At most three short sentences before the example.*
|
|
21
|
-
|
|
22
|
-
Example:
|
|
23
|
-
|
|
24
|
-
| Field | Value |
|
|
25
|
-
|---|---|
|
|
26
|
-
| <name> | <a real value> |
|
|
27
|
-
|
|
28
|
-
Picture: <who or what> → <what happens> → <result>
|
|
29
|
-
|
|
30
|
-
### Step 2 — <the problem today>
|
|
31
|
-
|
|
32
|
-
*Show the problem with a real case.*
|
|
33
|
-
|
|
34
|
-
Example: <the real case>
|
|
35
|
-
|
|
36
|
-
Picture: <today's flow> → <where it breaks>
|
|
37
|
-
|
|
38
|
-
## Part 2 — How it flows
|
|
39
|
-
|
|
40
|
-
### Step 3 — <the first move in the new flow>
|
|
41
|
-
|
|
42
|
-
*Each step adds one piece to the part's picture.*
|
|
43
|
-
|
|
44
|
-
Example:
|
|
45
|
-
|
|
46
|
-
```text
|
|
47
|
-
<a real command and its real output>
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Picture: <input> → <step> → <output>
|
|
51
|
-
|
|
52
|
-
## Part 3 — How it works
|
|
53
|
-
|
|
54
|
-
### Step 4 — <one component>
|
|
55
|
-
|
|
56
|
-
*Name the files, the data and the boundaries this step touches.*
|
|
57
|
-
|
|
58
|
-
Example: <a real record, call or file>
|
|
59
|
-
|
|
60
|
-
Picture: <component> → <component>
|
|
61
|
-
|
|
62
|
-
## Part 4 — Decisions and done
|
|
63
|
-
|
|
64
|
-
### Step 5 — Choices we made
|
|
65
|
-
|
|
66
|
-
*List each decision with its reason. Say what you rejected.*
|
|
67
|
-
|
|
68
|
-
Example: <the owner's words, or the evidence>
|
|
69
|
-
|
|
70
|
-
Picture: <choice> → <reason>
|
|
71
|
-
|
|
72
|
-
## Part 5 — Reference
|
|
73
|
-
|
|
74
|
-
### Approaches considered
|
|
75
|
-
|
|
76
|
-
- **A — <name>**: <cost, risk>. Rejected because <reason>.
|
|
77
|
-
- **B — <name>**: <cost, risk>. Chosen.
|
|
78
|
-
|
|
79
|
-
### Risks
|
|
80
|
-
|
|
81
|
-
1. <what breaks or bites later> — <mitigation, or "accepted">
|
|
82
|
-
|
|
83
|
-
### Test plan
|
|
84
|
-
|
|
85
|
-
<how each check is proved: suites, scenarios, live checks>
|
|
86
|
-
|
|
87
|
-
## Questions
|
|
88
|
-
|
|
89
|
-
*Each open question has an id and a default. Empty this list before you
|
|
90
|
-
ask for approval.*
|
|
91
|
-
|
|
92
|
-
- Q-1 — <question>? Default: <answer>.
|
|
93
|
-
|
|
94
|
-
## Definition of done
|
|
95
|
-
|
|
96
|
-
*Numbered checks, written before the build. The verifier proves each one.
|
|
97
|
-
Name each existing test this work changes.*
|
|
98
|
-
|
|
99
|
-
1. <check>
|
|
100
|
-
|
|
101
|
-
## Kind of change, impact and undo
|
|
102
|
-
|
|
103
|
-
*A change that cannot be undone goes in bold at the top of this file.*
|
|
104
|
-
|
|
105
|
-
- Kind: <what kind of change>
|
|
106
|
-
- Impact: <who or what it touches>
|
|
107
|
-
- Undo: <how to undo it>
|
|
108
|
-
- Existing tests changed: <list, or none>
|
|
109
|
-
|
|
110
|
-
## Approval
|
|
111
|
-
|
|
112
|
-
*Record the owner's own words and the date. A change after approval needs
|
|
113
|
-
a new approval, written here with its date.*
|
|
114
|
-
|
|
115
|
-
Approved: <date>. The owner's words: "<words>".
|
|
116
|
-
|
|
117
|
-
## Changes after approval
|
|
118
|
-
|
|
119
|
-
| Date | What changed | Why | Owner's words |
|
|
120
|
-
|---|---|---|---|
|
|
121
|
-
|
|
122
|
-
## Key
|
|
123
|
-
|
|
124
|
-
*Every id, code and short name used in this file, with its meaning.*
|
|
125
|
-
|
|
126
|
-
- **Q-1** — <meaning>
|