agentme 0.3.0 → 0.3.1

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

@@ -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-005](../../../.xdrs/agentme/edrs/devops/005-monorepo-structure.md):
 top-level application folders, a shared library area, 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 EDR: [agentme-edr-005](../../005-monorepo-structure.md)
+Related EDRs: [agentme-edr-005](../../../.xdrs/agentme/edrs/devops/005-monorepo-structure.md), [agentme-edr-013](../../../.xdrs/agentme/edrs/governance/013-contributing-guide-requirements.md)
 
 ## Instructions
 
@@ -96,6 +96,29 @@ Must include four sections:
 | `<app2>/`           | <Short description of app2>        |
 ```
 
+#### Root `CONTRIBUTING.md`
+
+Must explain the contribution workflow in a short, explicit way.
+
+```markdown
+# Contributing
+
+## Bugs
+Report bugs in GitHub issues with steps to reproduce, expected behavior, and actual behavior.
+
+## Features
+Discuss feature ideas in an issue before opening a pull request so scope and approach can be agreed first.
+
+## Pull requests
+Submit fixes and features through pull requests from feature branches targeting `main`.
+
+## Review etiquette
+Use [Conventional Comments](https://conventionalcomments.org/) in review feedback.
+
+## Keep changes focused
+Keep pull requests small and focused enough that review and discussion stay efficient.
+```
+
 ---
 
 ### Phase 3: Create the `shared/` area
@@ -219,6 +242,7 @@ After scaffolding, run the following checks and fix any issues:
 - `make lint` at the repository root passes.
 - `make test` at the repository root passes.
 - All folder and file names are lowercase and use hyphens.
+- A `CONTRIBUTING.md` exists at the repository root and covers bugs, feature discussions, pull requests, Conventional Comments, and small focused changes.
 - Every application folder has a `README.md` covering all four required sections.
 - A `.mise.toml` exists at the repository root with all required tool versions pinned.
 
@@ -267,4 +291,4 @@ test:
 - **Cross-application dependency requested:** Refuse and suggest publishing the shared code as a library in `shared/libs/` instead.
 - **Module with no compilable output (e.g., pure scripts):** Still create the Makefile; `build` can be a no-op (`@true`) but the target must exist.
 - **Language not listed above:** Mirror the pattern — `build` produces an artifact, `lint` runs static analysis, `test` runs tests. Adapt commands to the actual toolchain.
-- **Existing files:** Never overwrite existing `README.md` or `Makefile` files without user confirmation. Diff and propose additions instead.
+- **Existing files:** Never overwrite existing `README.md`, `CONTRIBUTING.md`, or `Makefile` files without user confirmation. Diff and propose additions instead.

package/.xdrs/agentme/edrs/governance/013-contributing-guide-requirements.md

@@ -0,0 +1,37 @@
+# agentme-edr-013: Contributing guide requirements
+
+## Context and Problem Statement
+
+Projects often document contributor expectations inconsistently or only inside README files, PR templates, or tribal knowledge. That causes avoidable review churn, premature feature implementation, and unfocused pull requests.
+
+What contributor workflow guidance must every project publish so contributors know how to report bugs, discuss features, and submit changes?
+
+## Decision Outcome
+
+**Every project must publish a root CONTRIBUTING.md with a small, explicit contribution workflow.**
+
+Projects must keep a `CONTRIBUTING.md` file at the repository root. The file must explain where bugs, feature discussions, and code changes belong so contributors follow a predictable workflow before opening pull requests.
+
+### Implementation Details
+
+- Every project **MUST** have a root `CONTRIBUTING.md`.
+- The guide **MUST** direct bug reports to issues.
+- The guide **MUST** direct feature ideas and feature discussions to issues before implementation starts.
+- The guide **MUST** state that fixes and features are contributed through pull requests.
+- The guide **MUST** state that pull requests come from feature branches targeting `main`.
+- The guide **MUST** ask reviewers and contributors to use [Conventional Comments](https://conventionalcomments.org/) for review feedback.
+- The guide **MUST** ask contributors to keep pull requests small enough to keep review and discussion focused.
+- Project scaffolding skills **SHOULD** create the file by default when they initialize a repository.
+- The content **SHOULD** stay concise and practical; do not turn `CONTRIBUTING.md` into a duplicate of `README.md`.
+
+## Considered Options
+
+* (REJECTED) **Keep contribution rules implicit** - Rely on README text, issue templates, or maintainers explaining the workflow ad hoc.
+  * Reason: Inconsistent contributor behavior and avoidable review overhead.
+* (CHOSEN) **Require a dedicated CONTRIBUTING.md** - Publish a short, explicit contribution workflow in a predictable location.
+  * Reason: Easy to discover, simple to scaffold, and clear enough for both humans and agents.
+
+## References
+
+- [agentme-edr-005 - Monorepo structure](../devops/005-monorepo-structure.md)
+- [002-monorepo-setup skill](../devops/skills/002-monorepo-setup/SKILL.md)

package/.xdrs/agentme/edrs/index.md

@@ -4,12 +4,6 @@ Engineering decisions specific to the agentme project: a curated library of XDRs
 
 Propose changes via pull request. All changes must be verified for clarity and non-conflict before merging.
 
-## Related scope indexes
-
-- [_core EDRs Index](../../_core/edrs/index.md) - Cross-business general standards (overridden by this scope where conflicts are documented)
-
-XDRs in scopes listed last override the ones listed first.
-
 ## Principles
 
 Foundational standards, principles, and guidelines.
@@ -32,6 +26,7 @@ Language and framework-specific tooling and project structure.
 
 - [agentme-edr-003](application/003-javascript-project-tooling.md) - **JavaScript project tooling and structure** *(includes skill: [001-create-javascript-project](application/skills/001-create-javascript-project/SKILL.md))*
 - [agentme-edr-010](application/010-golang-project-tooling.md) - **Go project tooling and structure** *(includes skill: [003-create-golang-project](application/skills/003-create-golang-project/SKILL.md))*
+- [004-select-relevant-xdrs](application/skills/004-select-relevant-xdrs/SKILL.md) - **Select relevant XDRs**
 
 ## Devops
 
@@ -41,6 +36,12 @@ Repository structure, build conventions, and CI/CD pipelines.
 - [agentme-edr-006](devops/006-github-pipelines.md) - **GitHub CI/CD pipelines**
 - [agentme-edr-008](devops/008-common-targets.md) - **Common development script names**
 
+## Governance
+
+Contribution and collaboration standards shared across projects.
+
+- [agentme-edr-013](governance/013-contributing-guide-requirements.md) - **Contributing guide requirements**
+
 ## Observability
 
 Health, metrics, logging, and monitoring standards.

package/.xdrs/index.md

@@ -28,5 +28,3 @@ Project-local XDRs that must not be shared with other contexts. Always keep this
 [View _local BDRs Index](_local/bdrs/index.md)
 
 [View _local ADRs Index](_local/adrs/index.md)
-
-[View _local EDRs Index](_local/edrs/index.md)

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "agentme",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "",
   "dependencies": {
-    "filedist": "^0.24.0",
-    "xdrs-core": "^0.5.0"
+    "filedist": "^0.26.0",
+    "xdrs-core": "^0.7.1"
   },
   "bin": "bin/filedist.js",
   "files": [