diff --git a/.joy/capabilities/assign.md b/.joy/capabilities/assign.md deleted file mode 100644 index 6fa146d..0000000 --- a/.joy/capabilities/assign.md +++ /dev/null @@ -1,33 +0,0 @@ -# assign - -Assign members to items and manage item assignments. -This is a management capability that controls access to `joy assign` -and `joy edit --assignees`. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | no | Assigning is a Joy operation, not a file operation | -| May run tests | no | Not relevant | -| Joy commands allowed | `joy assign`, `joy edit --assignees` | Core permissions this capability grants | -| Requires combination | Often combined with `plan` or `manage` | Assignment is part of planning or management | - -## Governance - -Without this capability, a member cannot assign anyone (including -themselves) to items. This is critical for AI governance: an AI tool -without `assign` cannot self-assign to items, even if it has work -capabilities like `implement`. Assignment must be done by a human or -an AI with explicit `assign` permission. - -## Agent Configuration - -```yaml -agent: - name: assigner - permissions: - allowed: [read, search, grep] - denied: [write, edit, delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe, qwen-code] -``` diff --git a/.joy/capabilities/conceive.md b/.joy/capabilities/conceive.md deleted file mode 100644 index 3da4bd6..0000000 --- a/.joy/capabilities/conceive.md +++ /dev/null @@ -1,29 +0,0 @@ -# conceive - -Define product vision, requirements, and process design. -This capability is exercised during the new -> open phase. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | no | Conceiving shapes ideas, not code | -| May run tests | no | No code to test at this stage | -| May create items | only with `create` | Conceiving alone does not grant item creation | -| May change status | yes | Approve items from new to open | - -## Agent Configuration - -```yaml -agent: - name: conceiver - permissions: - allowed: [read, search, grep] - denied: [write, edit, delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe] -``` - -## Interaction - -Default mode: pairing. Conceiving is a co-creation activity where -human and AI explore ideas together step by step. diff --git a/.joy/capabilities/create.md b/.joy/capabilities/create.md deleted file mode 100644 index 85848c5..0000000 --- a/.joy/capabilities/create.md +++ /dev/null @@ -1,32 +0,0 @@ -# create - -Create new items in the backlog. -This is a management capability that controls access to `joy add`. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | no | Creating items is a Joy operation, not a file operation | -| May run tests | no | Not relevant | -| Joy commands allowed | `joy add` | Core permission this capability grants | -| Requires combination | Often combined with `plan` or `conceive` | Creating items without planning context is rarely useful | - -## Governance - -Without this capability, a member cannot create items. This prevents -AI tools from generating items autonomously. A planner needs -`conceive, plan, create` to define and create items. An implementer -with only `implement` cannot add items -- discovered bugs must be -reported to someone with `create`. - -## Agent Configuration - -```yaml -agent: - name: creator - permissions: - allowed: [read, search, grep] - denied: [write, edit, delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe, qwen-code] -``` diff --git a/.joy/capabilities/delete.md b/.joy/capabilities/delete.md deleted file mode 100644 index c6a42b7..0000000 --- a/.joy/capabilities/delete.md +++ /dev/null @@ -1,31 +0,0 @@ -# delete - -Remove items from the backlog. -This is a management capability that controls access to `joy rm`. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | no | Deleting items is a Joy operation, not a file operation | -| May run tests | no | Not relevant | -| Joy commands allowed | `joy rm` | Core permission this capability grants | -| Destructive | yes | Deletion is irreversible in the working tree | - -## Governance - -Without this capability, a member cannot delete items. This is the -most restrictive management capability. AI tools should rarely have -`delete` -- prefer closing or deferring items over deletion to -preserve the audit trail. - -## Agent Configuration - -```yaml -agent: - name: deleter - permissions: - allowed: [read, search, grep] - denied: [write, edit, delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe, qwen-code] -``` diff --git a/.joy/capabilities/design.md b/.joy/capabilities/design.md deleted file mode 100644 index 8d0c24f..0000000 --- a/.joy/capabilities/design.md +++ /dev/null @@ -1,30 +0,0 @@ -# design - -Technical architecture, API design, data model decisions. -This capability is exercised during the open -> in-progress phase. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | yes | Design may produce architecture docs, diagrams | -| May run tests | no | Design precedes implementation | -| May create items | only with `create` | Design may identify sub-tasks | -| May change status | no | Design does not approve or close | - -## Agent Configuration - -```yaml -agent: - name: designer - permissions: - allowed: [read, search, grep, write, edit] - denied: [delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe] -``` - -## Interaction - -Default mode: interactive. Design decisions have lasting impact. -The designer presents architectural options with trade-offs and -waits for the user to decide. diff --git a/.joy/capabilities/document.md b/.joy/capabilities/document.md deleted file mode 100644 index 7ccd71f..0000000 --- a/.joy/capabilities/document.md +++ /dev/null @@ -1,30 +0,0 @@ -# document - -Write or update documentation, including architecture docs, API docs, -user guides, and inline code documentation. -This capability is exercised during in-progress and review phases. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | yes | Core activity: writing documentation | -| May run tests | no | Documentation does not require test execution | -| May create items | no | Documentation follows existing items | -| May change status | no | Documentation alone does not close items | - -## Agent Configuration - -```yaml -agent: - name: documenter - permissions: - allowed: [read, search, grep, write, edit] - denied: [delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe] -``` - -## Interaction - -Default mode: collaborative. The documenter proposes structure and content, -proceeds after confirmation. diff --git a/.joy/capabilities/implement.md b/.joy/capabilities/implement.md deleted file mode 100644 index 6858722..0000000 --- a/.joy/capabilities/implement.md +++ /dev/null @@ -1,29 +0,0 @@ -# implement - -Write code, configuration, and infrastructure. -This capability is exercised during the in-progress phase. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | yes | Core activity: writing code | -| May run tests | yes | Verifying own implementation | -| May create items | no | Implementation follows the plan | -| May change status | yes | Start and submit for review | - -## Agent Configuration - -```yaml -agent: - name: implementer - permissions: - allowed: [read, search, grep, write, edit, bash] - denied: [delete] - applicable_tools: [claude-code, github-copilot, mistral-vibe, qwen-code] -``` - -## Interaction - -Default mode: collaborative. The implementer proposes an approach, -proceeds after confirmation, and works independently on the code. diff --git a/.joy/capabilities/manage.md b/.joy/capabilities/manage.md deleted file mode 100644 index e6731bc..0000000 --- a/.joy/capabilities/manage.md +++ /dev/null @@ -1,32 +0,0 @@ -# manage - -Manage project configuration and member administration. -This is a management capability that controls access to project-level -operations. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | no | Managing is a Joy operation, not a file operation | -| May run tests | no | Not relevant | -| Joy commands allowed | `joy project member add/rm`, `joy config set` | Core permissions this capability grants | -| Typically held by | Project leads, administrators | High-trust capability | - -## Governance - -Without this capability, a member cannot add or remove project members, -or change project configuration. This prevents AI tools from modifying -the project's governance structure. Only explicitly trusted members -should hold `manage`. - -## Agent Configuration - -```yaml -agent: - name: manager - permissions: - allowed: [read, search, grep] - denied: [write, edit, delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe, qwen-code] -``` diff --git a/.joy/capabilities/plan.md b/.joy/capabilities/plan.md deleted file mode 100644 index cf886ea..0000000 --- a/.joy/capabilities/plan.md +++ /dev/null @@ -1,29 +0,0 @@ -# plan - -Break down work, scope items, prioritize, and estimate effort. -This capability is exercised during the new -> open phase. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | no | Planning scopes work, does not produce code | -| May run tests | no | No code to test at this stage | -| May create items | only with `create` | Breaking down epics requires item creation | -| May change status | yes | Move items through triage | - -## Agent Configuration - -```yaml -agent: - name: planner - permissions: - allowed: [read, search, grep] - denied: [write, edit, delete, bash] - applicable_tools: [claude-code, github-copilot, mistral-vibe] -``` - -## Interaction - -Default mode: interactive. The planner presents options with rationale -and waits for the user to decide on scope, priority, and breakdown. diff --git a/.joy/capabilities/review.md b/.joy/capabilities/review.md deleted file mode 100644 index f193640..0000000 --- a/.joy/capabilities/review.md +++ /dev/null @@ -1,29 +0,0 @@ -# review - -Verify correctness, quality, and adherence to project standards. -This capability is exercised during the review -> closed transition. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | no | Review observes, it does not change | -| May run tests | yes | Verifying existing tests is part of review | -| May create items | no | Findings are reported as comments | -| May change status | yes | Accept or rework | - -## Agent Configuration - -```yaml -agent: - name: reviewer - permissions: - allowed: [read, search, grep, test] - denied: [write, edit, delete] - applicable_tools: [claude-code, github-copilot, mistral-vibe] -``` - -## Interaction - -Default mode: interactive. The reviewer presents findings with rationale -and waits for the assignee or author to decide on each point. diff --git a/.joy/capabilities/test.md b/.joy/capabilities/test.md deleted file mode 100644 index 33c7e3c..0000000 --- a/.joy/capabilities/test.md +++ /dev/null @@ -1,29 +0,0 @@ -# test - -Verify correctness, write tests, validate behavior. -This capability is exercised during the in-progress phase. - -## Constraints - -| Rule | Value | Reason | -|------|-------|--------| -| May modify files | yes | Writing test code | -| May run tests | yes | Core activity: running tests | -| May create items | no | Test findings are reported as comments | -| May change status | no | Testing does not approve or close | - -## Agent Configuration - -```yaml -agent: - name: tester - permissions: - allowed: [read, search, grep, write, edit, bash] - denied: [delete] - applicable_tools: [claude-code, github-copilot, mistral-vibe, qwen-code] -``` - -## Interaction - -Default mode: supervised. The tester works independently but confirms -before irreversible actions like modifying production code.