agentme 0.28.1 → 0.29.0

package/.xdrs/agentme/edrs/platform/{005-monorepo-structure.md → 301-monorepo-structure.md}

@@ -1,11 +1,11 @@
 ---
-name: agentme-edr-policy-005-monorepo-structure
+name: agentme-edr-policy-301-monorepo-structure
 description: Defines the standard monorepo layout, naming, and build conventions using shared areas, Mise, and Makefiles. Use when creating or reviewing monorepos.
 apply-to: Monorepo projects
 valid-from: 2026-05-25
 ---
 
-# agentme-edr-policy-005: Monorepo structure
+# agentme-edr-policy-301: Monorepo structure
 
 ## Context and Problem Statement
 
@@ -78,7 +78,7 @@ Every monorepo MUST follow this top-level directory layout:
 
 A `Makefile` MUST be present at the repository root, in every application folder, and in every module folder.
 
-All Makefiles MUST use the shared target vocabulary from [agentme-edr-008](008-common-targets.md).
+All Makefiles MUST use the shared target vocabulary from [agentme-edr-303](303-common-targets.md).
 
 Repository, application, and module Makefiles MUST define at minimum: `all`, `build`, `lint`, `test`, and `clean`.
 
@@ -94,7 +94,7 @@ The root `setup` target MUST run `mise install` and any small repository bootstr
 - Every language runtime or CLI referenced by any module `Makefile`, CI workflow, or README command MUST be pinned in `.mise.toml`.
 - Contributors and CI run `make setup` after cloning or checkout; this target MUST call `mise install`.
 - Agents and contributors MUST check `.mise.toml` before using a system-installed compiler, runtime, or CLI.
-- When `.mise.toml` exists, all build, test, lint, and code-generation commands MUST run through `make <target>`, and the Makefile recipes MUST execute the underlying tools via `mise exec -- <command>`, following [agentme-edr-017](017-tool-execution-and-scripting.md).
+- When `.mise.toml` exists, all build, test, lint, and code-generation commands MUST run through `make <target>`, and the Makefile recipes MUST execute the underlying tools via `mise exec -- <command>`, following [agentme-edr-304](304-tool-execution-and-scripting.md).
 - If a required tool is missing, the first remediation step MUST be to update `.mise.toml` or run `mise install`, not to install ad-hoc global tools with language-specific installers such as `go install`, `npm install -g`, `pip install --user`, or `cargo install`.
 - Root and module `Makefile` targets MUST work when invoked as plain `make <target>` after `make setup`.
 

package/.xdrs/agentme/edrs/platform/{006-github-pipelines.md → 302-github-pipelines.md}

@@ -1,11 +1,11 @@
 ---
-name: agentme-edr-policy-006-github-ci-cd-pipelines
+name: agentme-edr-policy-302-github-ci-cd-pipelines
 description: Defines the standard GitHub Actions workflow split for CI, release tagging, and publishing. Use when configuring project automation.
 apply-to: Projects using GitHub Actions
 valid-from: 2026-05-25
 ---
 
-# agentme-edr-policy-006: GitHub CI/CD pipelines
+# agentme-edr-policy-302: GitHub CI/CD pipelines
 
 ## Context and Problem Statement
 
@@ -142,7 +142,7 @@ jobs:
 
 *Why rebuild on publish:* The checkout is done from the exact tag commit. Rebuilding ensures the published artifact matches exactly what is tagged, rather than relying on a prior CI artifact.
 
-*Why `id-token: write`:* Required for npm provenance attestation via `npm publish --provenance`, as specified in [agentme-edr-003](../application/003-javascript-project-tooling.md).
+*Why `id-token: write`:* Required for npm provenance attestation via `npm publish --provenance`, as specified in [agentme-edr-101](../application/101-javascript-project-tooling.md).
 
 ---
 

package/.xdrs/agentme/edrs/platform/{008-common-targets.md → 303-common-targets.md}

@@ -1,11 +1,11 @@
 ---
-name: agentme-edr-policy-008-common-development-script-names
+name: agentme-edr-policy-303-common-development-script-names
 description: Defines standard Makefile target names and the mandatory tool-execution flow using Mise. Use when designing build, lint, test, and release entry points.
 apply-to: All projects with Makefiles
 valid-from: 2026-05-25
 ---
 
-# agentme-edr-policy-008: Common development script names
+# agentme-edr-policy-303: Common development script names
 
 ## Context and Problem Statement
 
@@ -15,7 +15,7 @@ What standard set of Makefile target names and execution rules should projects a
 
 ## Decision Outcome
 
-**Every project MUST expose its development actions through a root `Makefile` using a defined set of standardized target names. Target implementation and tool-execution rules follow [agentme-edr-017](017-tool-execution-and-scripting.md), which requires `mise exec --` before routine tool commands.**
+**Every project MUST expose its development actions through a root `Makefile` using a defined set of standardized target names. Target implementation and tool-execution rules follow [agentme-edr-304](304-tool-execution-and-scripting.md), which requires `mise exec --` before routine tool commands.**
 
 Standardizing both the target names and the execution chain removes per-project guesswork, makes CI pipelines reusable, and keeps tooling behavior visible in one place.
 
@@ -49,7 +49,7 @@ make <target>
 
 - The `setup` target MUST run `mise install` and any small project-specific bootstrap needed before normal targets work.
 - Routine targets such as `build`, `lint`, `test`, `run`, and `publish` MUST be invoked as `make <target>` by both contributors and CI.
-- Each Makefile recipe MUST call the real underlying command through `mise exec --`, following [agentme-edr-017](017-tool-execution-and-scripting.md).
+- Each Makefile recipe MUST call the real underlying command through `mise exec --`, following [agentme-edr-304](304-tool-execution-and-scripting.md).
 - Makefile recipes MUST NOT add extra script layers such as `npm run`, `pnpm run`, `yarn run`, `mise run`, `mise tasks`, or shell aliases when those layers only forward to another command.
 - Calling the actual tool is allowed even when that tool itself launches another program as part of its normal interface.
 	- Allowed: `mise exec -- pnpm exec eslint ./src`
@@ -167,7 +167,7 @@ test:
 
 A developer can run `make test` at the repo root to test everything, or `cd module-a && make test` to test a single module. Both MUST work.
 
-**Reference:** See [agentme-edr-005](005-monorepo-structure.md) for the full monorepo layout convention.
+**Reference:** See [agentme-edr-301](301-monorepo-structure.md) for the full monorepo layout convention.
 
 ---
 
@@ -228,7 +228,7 @@ Subtargets that require external dependencies (e.g., `test-integration` against
 
 #### 09-ai-project-dev-targets
 
-AI-based projects (LLM, Agent, and Workflow tiers as defined in [agentme-edr-040](../application/040-ai-llm-development-standards.md)) MUST expose a `dev-mlflow` target that starts a local MLflow tracking server for development inspection.
+AI-based projects (LLM, Agent, and Workflow tiers as defined in [agentme-edr-141](../application/141-ai-llm-development-standards.md)) MUST expose a `dev-mlflow` target that starts a local MLflow tracking server for development inspection.
 
 **Example implementation:**
 
@@ -251,5 +251,5 @@ dev-mlflow:
 
 ## References
 
-- [agentme-edr-005](005-monorepo-structure.md) - Monorepo layout and delegation structure
-- [agentme-edr-017](017-tool-execution-and-scripting.md) - Tool-execution rules for Makefile targets and CI
+- [agentme-edr-301](301-monorepo-structure.md) - Monorepo layout and delegation structure
+- [agentme-edr-304](304-tool-execution-and-scripting.md) - Tool-execution rules for Makefile targets and CI

package/.xdrs/agentme/edrs/platform/{017-tool-execution-and-scripting.md → 304-tool-execution-and-scripting.md}

@@ -1,11 +1,11 @@
 ---
-name: agentme-edr-policy-017-tool-execution-and-scripting
+name: agentme-edr-policy-304-tool-execution-and-scripting
 description: Defines how Makefiles, CI pipelines, and optional wrapper scripts execute project commands. Use when designing project automation or command entry points.
 apply-to: All projects with Makefiles and CI pipelines
 valid-from: 2026-05-25
 ---
 
-# agentme-edr-policy-017: Tool execution and scripting
+# agentme-edr-policy-304: Tool execution and scripting
 
 ## Context and Problem Statement
 
@@ -15,14 +15,14 @@ How should projects execute development commands so the command surface stays pr
 
 ## Decision Outcome
 
-**Use Makefiles as the only authoritative command entry point, with targets named by [agentme-edr-008](008-common-targets.md) and implemented with `mise exec --` before the real tool command.**
+**Use Makefiles as the only authoritative command entry point, with targets named by [agentme-edr-303](303-common-targets.md) and implemented with `mise exec --` before the real tool command.**
 
 This keeps local development and CI aligned, reduces indirection, and lets contributors understand project behavior by reading one command surface.
 
 ### Details
 
 - Every project MUST use a root `Makefile` as the authoritative entry point for developer and pipeline commands.
-- The target names in that `Makefile` MUST follow [agentme-edr-008](008-common-targets.md).
+- The target names in that `Makefile` MUST follow [agentme-edr-303](303-common-targets.md).
 - CI pipelines MUST run `make <target>` from the relevant root instead of calling language-specific scripts such as `npm run`, `pnpm run`, shell wrappers, or secondary task runners.
 - A Makefile target MUST execute the real operation through `mise exec --` before invoking the tool itself, so it MUST use the version pinned in `.mise.toml`. Avoid intermediate script layers that hide the actual command.
 - Every Makefile target MUST start by echoing a concise summary of the target and folder or context, using fewer than 10 words. When delegating to another Makefile, echo the child path and delegated target before invoking it.
@@ -58,9 +58,9 @@ Disallowed:
 
 ## References
 
-- [agentme-edr-005](005-monorepo-structure.md) - Monorepo layout and Makefile hierarchy
-- [agentme-edr-006](006-github-pipelines.md) - CI/CD workflows should call Make targets
-- [agentme-edr-008](008-common-targets.md) - Standard target names
-- [agentme-edr-003](../application/003-javascript-project-tooling.md) - JavaScript tooling commands inside Makefiles
-- [agentme-edr-010](../application/010-golang-project-tooling.md) - Go tooling commands inside Makefiles
-- [agentme-edr-014](../application/014-python-project-tooling.md) - Python tooling commands inside Makefiles
+- [agentme-edr-301](301-monorepo-structure.md) - Monorepo layout and Makefile hierarchy
+- [agentme-edr-302](302-github-pipelines.md) - CI/CD workflows should call Make targets
+- [agentme-edr-303](303-common-targets.md) - Standard target names
+- [agentme-edr-101](../application/101-javascript-project-tooling.md) - JavaScript tooling commands inside Makefiles
+- [agentme-edr-102](../application/102-golang-project-tooling.md) - Go tooling commands inside Makefiles
+- [agentme-edr-103](../application/103-python-project-tooling.md) - Python tooling commands inside Makefiles

package/.xdrs/agentme/edrs/platform/{027-environment-variable-configuration.md → 305-environment-variable-configuration.md}

@@ -1,11 +1,11 @@
 ---
-name: agentme-edr-policy-027-environment-variable-configuration-files
+name: agentme-edr-policy-305-environment-variable-configuration-files
 description: Defines when to use YAML config files versus .env files for configuration, how to combine them, and how .env is loaded for spawned processes. Use when setting up project configuration for any application, CLI, or library.
 apply-to: All projects that use environment variables for configuration
 valid-from: 2026-06-09
 ---
 
-# agentme-edr-policy-027: Environment variable configuration files
+# agentme-edr-policy-305: Environment variable configuration files
 
 ## Context and Problem Statement
 
@@ -19,7 +19,7 @@ How should projects manage environment variable configuration and CLI invocation
 
 **Use YAML config files for CLI invocation configuration with multiple attributes; use `.env` files to supply environment variables to spawned processes and to hold uncommitted values referenced by config files. Load `.env` exclusively at process launch time — MUST NOT be loaded inside application code.**
 
-Secrets (API keys, passwords, tokens) MUST NOT be placed in `.env` files. Those are handled by [agentme-edr-022](../application/022-secrets-management.md).
+Secrets (API keys, passwords, tokens) MUST NOT be placed in `.env` files. Those are handled by [agentme-edr-124](../application/124-secrets-management.md).
 
 ### Details
 
@@ -28,7 +28,7 @@ Secrets (API keys, passwords, tokens) MUST NOT be placed in `.env` files. Those
 A `.env` file MUST be used when either of the following is true:
 
 1. **Spawned process needs env vars** — the project launches a process (a deployable service, background worker, or shell script) that reads configuration from OS environment variables such as port numbers or API endpoint URLs.
-2. **Value must not be committed** — a configuration value used in a YAML config file (see rule 07) is environment-specific or sensitive enough to exclude from version control. In that case, store the value in `.env` and reference it from the YAML file using env var substitution (see rule 08).
+2. **Value MUST NOT be committed** — a configuration value used in a YAML config file (see rule 07) is environment-specific or sensitive enough to exclude from version control. In that case, store the value in `.env` and reference it from the YAML file using env var substitution (see rule 08).
 
 Do not use `.env` as a general-purpose configuration store when a YAML config file is the right tool (see rule 07).
 
@@ -64,7 +64,7 @@ FEATURE_FLAG_NEW_UI=false
 
 Stage-specific overrides MUST use the naming convention `.env.[stage]` (e.g., `.env.production`, `.env.staging`, `.env.test`). These files may be committed to the repository because they carry deployment-stage configuration rather than local developer configuration. They are used during deployment pipelines where the stage is known and explicit.
 
-The generic `.env` must still not be committed. The distinction is: `.env` is for local, ad-hoc, standalone use; `.env.[stage]` is for deployment pipelines with a defined environment identity.
+The generic `.env` MUST NOT be committed. The distinction is: `.env` is for local, ad-hoc, standalone use; `.env.[stage]` is for deployment pipelines with a defined environment identity.
 
 ---
 
@@ -85,7 +85,7 @@ This ensures all variables in `.env` are available as environment variables to e
 
 #### 06-no-application-level-dotenv-loading
 
-Applications MUST NOT load `.env` files directly inside their own code using dotenv libraries or equivalent mechanisms. Configuration must enter the process exclusively as OS-level environment variables, set before the process is launched (by the Makefile, a shell script, CI, or a container runtime).
+Applications MUST NOT load `.env` files directly inside their own code using dotenv libraries or equivalent mechanisms. Configuration MUST enter the process exclusively as OS-level environment variables, set before the process is launched (by the Makefile, a shell script, CI, or a container runtime).
 
 Prohibited patterns:
 
@@ -116,9 +116,9 @@ This rule prevents two parallel loading paths — OS env and file-based env —
 
 CLI adapters with multiple configuration attributes MUST use a YAML config file rather than env vars or flags for those attributes. This applies whenever configuration is nested, repetitive, or too verbose for flags alone.
 
-The CLI layer is responsible for loading and parsing the YAML file and passing the resolved values to the application layer. The application layer must not read the config file directly.
+The CLI layer is responsible for loading and parsing the YAML file and passing the resolved values to the application layer. The application layer MUST NOT read the config file directly.
 
-Default config file discovery should follow the pattern defined in [agentme-edr-015](../application/015-cli-tool-standards.md): load `[cwd]/[tool-name].yml` by default, or an explicit path provided via `--config`.
+Default config file discovery SHOULD follow the pattern defined in [agentme-edr-104](../application/104-cli-tool-standards.md): load `[cwd]/[tool-name].yml` by default, or an explicit path provided via `--config`.
 
 Example `myconfig.yml`:
 ```yaml
@@ -131,7 +131,7 @@ max_retries: 3
 
 #### 08-env-var-substitution-in-config-files
 
-When a YAML config file contains a value that MUST NOT be committed (such as a real endpoint URL, a username, or any other environment-specific value), that value must be expressed as an environment variable reference using `${VAR_NAME}` syntax, and the actual value must be defined in `.env`.
+When a YAML config file contains a value that MUST NOT be committed (such as a real endpoint URL, a username, or any other environment-specific value), that value MUST be expressed as an environment variable reference using `${VAR_NAME}` syntax, and the actual value MUST be defined in `.env`.
 
 This keeps the YAML file committable while keeping the environment-specific value out of the repository.
 
@@ -148,11 +148,11 @@ openapi_endpoint: ${OPENAPI_ENDPOINT}
 log_level: debug
 ```
 
-The `.env` file must be loaded in the Makefile before launching the process (see rule 05) so the variable is available when the CLI or process reads the config file.
+The `.env` file MUST be loaded in the Makefile before launching the process (see rule 05) so the variable is available when the CLI or process reads the config file.
 
 ## References
 
-- [agentme-edr-022](../application/022-secrets-management.md) - Secrets must use OS keychains or cloud secret managers, not `.env` files
-- [agentme-edr-017](017-tool-execution-and-scripting.md) - Makefiles are the authoritative command entry point; rule 05 above integrates with that standard
-- [agentme-edr-008](008-common-targets.md) - Standard Makefile target names
-- [agentme-edr-015](../application/015-cli-tool-standards.md) - CLI config file discovery and CLI-to-application separation
+- [agentme-edr-124](../application/124-secrets-management.md) - Secrets must use OS keychains or cloud secret managers, not `.env` files
+- [agentme-edr-304](304-tool-execution-and-scripting.md) - Makefiles are the authoritative command entry point; rule 05 above integrates with that standard
+- [agentme-edr-303](303-common-targets.md) - Standard Makefile target names
+- [agentme-edr-104](../application/104-cli-tool-standards.md) - CLI config file discovery and CLI-to-application separation

package/.xdrs/agentme/edrs/platform/skills/002-monorepo-setup/SKILL.md

@@ -3,7 +3,7 @@ name: 002-monorepo-setup
 description: >
   Step-by-step instructions for setting up and scaffolding a new monorepo following the standard
   layout, naming conventions, Makefiles, Mise tooling, and README requirements defined in
-  agentme-edr-005. Activate this skill when the user asks to create, initialize, or set up a
+  agentme-edr-301. Activate this skill when the user asks to create, initialize, or set up a
   monorepo, add a new application or module to an existing monorepo, or verify that a monorepo
   complies with the standard structure.
 metadata:
@@ -13,12 +13,12 @@ metadata:
 
 ## Overview
 
-Creates or extends a monorepo that follows the standard layout from [agentme-edr-005](../../005-monorepo-structure.md):
+Creates or extends a monorepo that follows the standard layout from [agentme-edr-301](../../301-monorepo-structure.md):
 top-level application folders, independent module roots, sibling example and multi-module test
 areas, Mise-managed tooling, and Makefiles at every level so any contributor can build, lint, and
 test any part of the monorepo with a single, predictable command.
 
-Related EDRs: [agentme-edr-005](../../005-monorepo-structure.md), [agentme-edr-013](../../../governance/013-contributing-guide-requirements.md), [agentme-edr-016](../../../principles/016-cross-language-module-structure.md)
+Related EDRs: [agentme-edr-301](../../301-monorepo-structure.md), [agentme-edr-502](../../../governance/502-contributing-guide-requirements.md), [agentme-edr-016](../../../principles/016-cross-language-module-structure.md)
 
 ## Instructions
 

package/.xdrs/agentme/edrs/principles/012-continuous-xdr-enrichment.md

@@ -35,7 +35,7 @@ When developers or coding agents need too much detailed steering to complete a t
 
 #### 04-coverage-target-should-be-80-percent
 
-Teams SHOULD aim to keep at least 80% of big coding decisions covered by accepted XDRs. Big decisions include framework or tool selection, overall code organization, monorepo structure, complex business flows, and coding standards. If a big decision is not yet covered, developers SHOULD either propose a new XDR or document why the decision is intentionally local and should not be shared.
+Teams SHOULD aim to keep at least 80% of big coding decisions covered by accepted XDRs. Big decisions include framework or tool selection, overall code organization, monorepo structure, complex business flows, and coding standards. If a big decision is not yet covered, developers SHOULD either propose a new XDR or document why the decision is intentionally local and SHOULD NOT be shared.
 
 #### 05-leaders-must-review-xdr-proposals
 

package/.xdrs/agentme/edrs/principles/016-cross-language-module-structure.md

@@ -25,7 +25,7 @@ Language-specific EDRs MAY add ecosystem details, but they MUST NOT redefine the
 
 A module is the smallest independently buildable, testable, or publishable unit. It MUST live in its own folder and that folder MUST contain:
 
-- a `Makefile` following [agentme-edr-008](../platform/008-common-targets.md)
+- a `Makefile` following [agentme-edr-303](../platform/303-common-targets.md)
 - a `README.md` for the module itself
 - all configuration files needed to build, lint, test, package, or publish that module
 - its generated `dist/` directory when the module produces distributable artifacts
@@ -127,9 +127,9 @@ Benchmark tests MUST live in one of these locations:
 
 #### 08-module-makefiles-must-expose-shared-targets
 
-Every module `Makefile` MUST expose the common target names from [agentme-edr-008](../platform/008-common-targets.md). At minimum, modules MUST provide `build`, `lint`, and `test`, and SHOULD also provide `all`, `clean`, and `lint-fix` when meaningful.
+Every module `Makefile` MUST expose the common target names from [agentme-edr-303](../platform/303-common-targets.md). At minimum, modules MUST provide `build`, `lint`, and `test`, and SHOULD also provide `all`, `clean`, and `lint-fix` when meaningful.
 
 ## References
 
-- [agentme-edr-005](../platform/005-monorepo-structure.md) - Monorepo aggregation and delegation rules
-- [agentme-edr-008](../platform/008-common-targets.md) - Shared Makefile target names
+- [agentme-edr-301](../platform/301-monorepo-structure.md) - Monorepo aggregation and delegation rules
+- [agentme-edr-303](../platform/303-common-targets.md) - Shared Makefile target names

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentme",
-  "version": "0.28.1",
+  "version": "0.29.0",
   "description": "",
   "dependencies": {
     "filedist": "^0.39.0"
@@ -18,6 +18,6 @@
     "url": "https://github.com/flaviostutz/agentme.git"
   },
   "devDependencies": {
-    "xdrs-core": "^0.39.0"
+    "xdrs-core": "^0.41.0"
   }
 }