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.
@@ -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. Preset Integrity (NON-NEGOTIABLE)
43
+ ### II. XDR as the Single Source of Truth for All Policies
44
44
 
45
- agentme distributes files to consumer projects via named presets (`basic`, `speckit`). Each
46
- preset MUST be independently coherent, non-overlapping, and verified on every build.
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
- - A preset MUST contain all files a consumer needs and nothing more.
49
- - Presets MUST NOT share extraction sets unless the consumer explicitly requests multiple presets.
50
- - The `examples/` folder MUST assert the exact file presence/absence for each preset combination
51
- after every `make build`.
52
- - Adding a file to a preset or changing selector patterns is a public API change and requires a
53
- version bump (MINOR or MAJOR depending on impact).
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 Principle III.
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 five principles for continued non-conflict.
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 five principles.
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.7.5",
3
+ "version": "0.8.0",
4
4
  "description": "",
5
5
  "dependencies": {
6
- "filedist": "^0.26.0",
7
- "xdrs-core": "^0.21.0"
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/**",