agentme 0.7.5 → 0.8.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/.specify/memory/constitution.md +33 -52
- package/package.json +4 -4
|
@@ -40,78 +40,59 @@ vibe coding, onboarding, and future feature development.
|
|
|
40
40
|
- EDRs capture concrete engineering decisions: tooling, structure, practices.
|
|
41
41
|
- Every non-trivial implementation decision MUST have a corresponding XDR entry before the implementation task is marked complete. Create new XDRs if necessary.
|
|
42
42
|
|
|
43
|
-
### II.
|
|
43
|
+
### II. XDR as the Single Source of Truth for All Policies
|
|
44
44
|
|
|
45
|
-
|
|
46
|
-
|
|
45
|
+
All quality standards, business policies, architectural policies, and engineering policies that
|
|
46
|
+
specs, plans, and implementations must follow MUST be captured exclusively in XDRs. The
|
|
47
|
+
constitution does not restate those rules; it defers to them.
|
|
47
48
|
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
|
|
52
|
-
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
### III. Consumer-First API Discipline
|
|
56
|
-
|
|
57
|
-
XDRs, skills, and preset file sets are a public API consumed by external projects. Changes MUST
|
|
58
|
-
respect semantic versioning.
|
|
59
|
-
|
|
60
|
-
- MAJOR: removing or renaming a preset, removing or restructuring an XDR that external consumers
|
|
61
|
-
reference, or any change that requires consumer-side migration.
|
|
62
|
-
- MINOR: adding a new preset, adding XDRs or skills, adding files to an existing preset.
|
|
63
|
-
- PATCH: wording, clarifications, typo fixes inside XDRs or skills that carry no structural change.
|
|
64
|
-
- Breaking changes MUST be documented in the release notes and in the relevant XDR's `Conflicts`
|
|
65
|
-
or `Implementation Details` section before merging.
|
|
66
|
-
|
|
67
|
-
### IV. Self-Contained Artifacts
|
|
68
|
-
|
|
69
|
-
Every XDR and skill MUST work without any implicit context outside itself.
|
|
70
|
-
|
|
71
|
-
- XDRs MUST be under 100 lines (hard limit 200 for templates and elaborate decisions).
|
|
72
|
-
- Skills MUST be under 500 lines; lengthy reference material goes in `references/`.
|
|
73
|
-
- Internal cross-references MUST use relative file paths; no absolute or external URLs without
|
|
74
|
-
explanation.
|
|
75
|
-
- A consumer reading an XDR or skill for the first time MUST be able to follow it without
|
|
76
|
-
accessing other systems.
|
|
77
|
-
|
|
78
|
-
### V. Simplicity and Verified Quality
|
|
79
|
-
|
|
80
|
-
The simplest solution that passes all tests is always preferred. Quality gates are non-negotiable.
|
|
81
|
-
|
|
82
|
-
- `make test` MUST pass before any release; failures block publish.
|
|
83
|
-
- Linting MUST be clean (`make lint-fix`) before merging.
|
|
84
|
-
- Files MUST NOT exceed 400 lines (test files excepted).
|
|
85
|
-
- No feature scope creep: implement only what the current spec requires.
|
|
86
|
-
- Avoid adding error handling, fallbacks, or abstractions for hypothetical future scenarios.
|
|
87
|
-
|
|
88
|
-
## Quality Requirements
|
|
89
|
-
|
|
90
|
-
- `make test` in `examples/` MUST verify all preset extraction scenarios end-to-end.
|
|
91
|
-
- XDRs produced during a feature MUST be reviewed for non-conflict before merging.
|
|
92
|
-
- All XDR indexes (`_local`, `agentme`, `_core`) MUST be updated before a PR is merged.
|
|
93
|
-
- New presets or selector changes MUST include updated test assertions in the examples Makefile.
|
|
49
|
+
- Quality gates (testing, linting, coverage thresholds, file-size limits) → EDRs.
|
|
50
|
+
- Business rules, consumer workflows, versioning contracts → BDRs.
|
|
51
|
+
- Architectural patterns, cross-cutting concerns, dependency strategies → ADRs.
|
|
52
|
+
- If a policy is not in an XDR, it is not an enforceable policy. Write the XDR first.
|
|
53
|
+
- Agents and humans MUST consult the XDR index before starting any work and MUST follow every
|
|
54
|
+
relevant XDR found there without exception.
|
|
94
55
|
|
|
95
56
|
## Development Workflow
|
|
96
57
|
|
|
97
58
|
1. Before starting a feature: check existing XDRs for applicable decisions.
|
|
98
59
|
2. During specifying (`speckit.specify`): capture business requirements as BDRs in `_local`.
|
|
60
|
+
**After every `speckit.specify` run the agent MUST offer to run `speckit.clarify` (refine)
|
|
61
|
+
before proceeding to planning. This is non-negotiable.**
|
|
99
62
|
3. During planning (`speckit.plan`): update or create ADRs and EDRs in `_local` that reflect
|
|
100
63
|
architectural and engineering decisions made during the planning phase.
|
|
64
|
+
**After every `speckit.plan` run the agent MUST propose running `speckit.checklist` to enrich
|
|
65
|
+
the plan with domain-specific quality checks before generating tasks.**
|
|
101
66
|
4. During implementation: follow XDRs; create new `_local` XDRs for decisions not yet captured.
|
|
102
67
|
5. After implementation: delete feature specs and plans; XDRs remain permanently.
|
|
103
68
|
6. Runtime guidance: see `.xdrs/index.md` and all linked scope indexes.
|
|
104
69
|
|
|
70
|
+
## XDR Compliance Check (Mandatory at Every Stage)
|
|
71
|
+
|
|
72
|
+
Every Spec, Refinement (clarify), Plan, Checklist, and Implementation task MUST include an
|
|
73
|
+
explicit step that verifies compliance with the XDRs present in the repository:
|
|
74
|
+
|
|
75
|
+
1. Read `.xdrs/index.md` and all linked scope indexes (`_local`, `agentme`, `_core`).
|
|
76
|
+
2. Identify every XDR relevant to the work being performed.
|
|
77
|
+
3. Confirm that the artifact (spec, plan, task list, or code change) does not contradict any
|
|
78
|
+
relevant XDR.
|
|
79
|
+
4. If a contradiction or gap is found: either update the artifact to comply, or create/update the
|
|
80
|
+
relevant XDR to reflect the new decision before continuing.
|
|
81
|
+
5. Document the compliance check result in the artifact (e.g., a "XDR Compliance" section or
|
|
82
|
+
comment) so reviewers can audit it.
|
|
83
|
+
|
|
84
|
+
No artifact may be considered complete without a passed XDR compliance check.
|
|
85
|
+
|
|
105
86
|
## Governance
|
|
106
87
|
|
|
107
88
|
This constitution supersedes all other development practices within this repository. Amendments
|
|
108
89
|
require:
|
|
109
|
-
1. A version bump following semantic versioning rules stated in
|
|
90
|
+
1. A version bump following semantic versioning rules stated in the relevant BDR/ADR/EDR.
|
|
110
91
|
2. An updated `LAST_AMENDED_DATE` in this file.
|
|
111
|
-
3. A review of all
|
|
92
|
+
3. A review of all principles for continued non-conflict.
|
|
112
93
|
4. An updated Sync Impact Report (HTML comment at the top of this file).
|
|
113
94
|
|
|
114
|
-
All PRs MUST include a "Constitution Check" section confirming compliance with all
|
|
95
|
+
All PRs MUST include a "Constitution Check" section confirming compliance with all principles.
|
|
115
96
|
Complexity MUST be justified; if a solution requires deviation from a principle, that deviation
|
|
116
97
|
MUST be documented in a new or updated XDR in `_local`.
|
|
117
98
|
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentme",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "",
|
|
5
5
|
"dependencies": {
|
|
6
|
-
"filedist": "^0.
|
|
7
|
-
"xdrs-core": "^0.21.
|
|
6
|
+
"filedist": "^0.28.1",
|
|
7
|
+
"xdrs-core": "^0.21.1"
|
|
8
8
|
},
|
|
9
9
|
"bin": "bin/filedist.js",
|
|
10
10
|
"files": [
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"filedist": {
|
|
25
25
|
"sets": [
|
|
26
26
|
{
|
|
27
|
-
"package": "xdrs-core",
|
|
27
|
+
"package": "xdrs-core@latest",
|
|
28
28
|
"selector": {
|
|
29
29
|
"files": [
|
|
30
30
|
".xdrs/_core/**",
|