Init nomadworks

.nomadworks/agents/README.md

@@ -0,0 +1,39 @@
+# Repository Agents
+
+Place full repository-local agent definitions here.
+
+- Use `.nomadworks/agents/<agent>.md` to override a bundled agent's full base definition.
+- Use `.nomadworks/agents/<agent>.md` to define a brand new custom repository agent.
+- Files in this folder are treated as full agent definitions.
+- `README.md` is ignored by agent discovery.
+
+## Include Types Available In Custom Agents
+
+Custom agents can use the same include resolution as bundled agents:
+
+- `<include:plugin:...>` for plugin-owned shared guidance
+- `<include:policy:...>` for repository-overridable policy files with bundled defaults
+- `<include:repo:...>` for explicit files under `.nomadworks/`
+
+## Common Plugin Includes
+
+- `plugin:Agents_Common.md`
+- `plugin:docs/core/agent_orchestration.md`
+- `plugin:docs/core/communication_guidelines.md`
+- `plugin:docs/core/discussion_agent_guidelines.md`
+- `plugin:docs/core/role_contracts.md`
+- `plugin:docs/core/task_model.md`
+- `plugin:docs/core/codemap_conventions.md`
+- `plugin:docs/core/pma_mode_full.md`
+- `plugin:docs/core/pma_mode_mini.md`
+- `plugin:docs/core/tech_lead_mode_full.md`
+- `plugin:docs/core/tech_lead_mode_mini.md`
+
+## Available Policy Includes
+
+- `policy:development-guidelines.md`
+- `policy:testing-guidelines.md`
+- `policy:documentation-guidelines.md`
+- `policy:git-commit-messaging.md`
+- `policy:product-guidelines.md`
+- `policy:ui-ux-guidelines.md`