Harness: migrate backlog to Forgejo issues + document MCP scoping limitation #1

New issue

Closed

opened 2026-07-19 02:28:37 +00:00 by agent · 2 comments

agent commented

2026-07-19 02:28:37 +00:00

Member

Goal

Move the residual backlog out of .agent/plans/*.md into Forgejo issues in residual/.agent, tier-labeled, and update agent prompts + AGENTS.md to track backlog as issues.

Schema validation finding (2026-07-18)

opencode 1.18.3 PermissionConfig has no mcp key. MCP servers are global — every agent gets every tool. Per-agent MCP tool allowlists (the original plan mechanism) are NOT supported. Mode intent (plan = read + issue create/edit; build = + PRs) will be expressed via prompt instructions only, not enforced at config level. Documented honestly in AGENTS.md.

Steps

Create tier labels (tier-1-quick-win, tier-2-project, tier-3-sheets, tier-4-os) + harness
Create this tracking issue
Migrate 10 .agent/plans/*.md → 10 issues (tier-labeled; fold handoff into create-repository-repo)
Update agent prompts: plan.md, residual.md, explore.md, review.md, docs.md, build.md, general.md
Update AGENTS.md §10.8 (backlog = issues; note MCP limitation)
Delete 10 .agent/plans/*.md; commit in workspace root
Verify: 10 issues present, .agent/plans/ empty, go build/test pass

Status

See comments for progress updates.

# Goal Move the residual backlog out of `.agent/plans/*.md` into Forgejo issues in `residual/.agent`, tier-labeled, and update agent prompts + AGENTS.md to track backlog as issues. # Schema validation finding (2026-07-18) opencode 1.18.3 `PermissionConfig` has **no `mcp` key**. MCP servers are global — every agent gets every tool. Per-agent MCP tool allowlists (the original plan mechanism) are **NOT supported**. Mode intent (plan = read + issue create/edit; build = + PRs) will be expressed via **prompt instructions only**, not enforced at config level. Documented honestly in AGENTS.md. # Steps - [x] Create tier labels (tier-1-quick-win, tier-2-project, tier-3-sheets, tier-4-os) + `harness` - [x] Create this tracking issue - [ ] Migrate 10 `.agent/plans/*.md` → 10 issues (tier-labeled; fold handoff into create-repository-repo) - [ ] Update agent prompts: plan.md, residual.md, explore.md, review.md, docs.md, build.md, general.md - [ ] Update AGENTS.md §10.8 (backlog = issues; note MCP limitation) - [ ] Delete 10 `.agent/plans/*.md`; commit in workspace root - [ ] Verify: 10 issues present, `.agent/plans/` empty, `go build/test` pass # Status See comments for progress updates.

agent added the

harness

label

2026-07-19 02:32:43 +00:00

agent commented

2026-07-19 02:33:02 +00:00

Author

Member

Status update (2026-07-19)

Migration complete. 10 backlog plans → issues in residual/.agent, tier-labeled:

#	Issue	Tier
2	res-sheets: calc multi-pass convergence	tier-1-quick-win
3	Unified residual theming (two-mode per-app)	tier-1-quick-win
4	build-tooling + res help-cache write (deferred)	tier-1-quick-win
5	Shared `:` command system (core/lib/cmd + ui + lua)	tier-2-project
6	res-sheets Phase 5: positional copy/cut	tier-3-sheets
7	res-sheets Phase 4g: array/spill (deferred design)	tier-3-sheets
8	Create `repository` APK repo (handoff folded in)	tier-4-infra
9	os/ ISO build pipeline	tier-4-os
10	os/ persistent overlay	tier-4-os

Labels created: tier-1-quick-win(3), tier-2-project(2), tier-3-sheets(4), tier-4-os(5), tier-4-infra(7), harness(6).

Next: update agent prompts (plan/residual/explore/review/docs/build/general) + AGENTS.md §10.8, then delete the 10 .agent/plans/*.md and commit.

Note: opencode 1.18.3 PermissionConfig has no mcp key — per-agent MCP tool scoping is NOT supported. Mode intent will be enforced via prompt instructions only; documented in AGENTS.md.

## Status update (2026-07-19) **Migration complete.** 10 backlog plans → issues in `residual/.agent`, tier-labeled: | # | Issue | Tier | |---|-------|------| | 2 | res-sheets: calc multi-pass convergence | tier-1-quick-win | | 3 | Unified residual theming (two-mode per-app) | tier-1-quick-win | | 4 | build-tooling + res help-cache write (deferred) | tier-1-quick-win | | 5 | Shared `:` command system (core/lib/cmd + ui + lua) | tier-2-project | | 6 | res-sheets Phase 5: positional copy/cut | tier-3-sheets | | 7 | res-sheets Phase 4g: array/spill (deferred design) | tier-3-sheets | | 8 | Create `repository` APK repo (handoff folded in) | tier-4-infra | | 9 | os/ ISO build pipeline | tier-4-os | | 10 | os/ persistent overlay | tier-4-os | Labels created: tier-1-quick-win(3), tier-2-project(2), tier-3-sheets(4), tier-4-os(5), tier-4-infra(7), harness(6). **Next:** update agent prompts (plan/residual/explore/review/docs/build/general) + AGENTS.md §10.8, then delete the 10 `.agent/plans/*.md` and commit. **Note:** opencode 1.18.3 `PermissionConfig` has no `mcp` key — per-agent MCP tool scoping is NOT supported. Mode intent will be enforced via prompt instructions only; documented in AGENTS.md.

agent commented

2026-07-19 02:35:51 +00:00

Author

Member

Status update (2026-07-19) — DONE

All steps complete:

Tier labels created (tier-1-quick-win, tier-2-project, tier-3-sheets, tier-4-os, tier-4-infra, harness)
Tracking issue #1 created
10 .agent/plans/*.md → 10 issues (#2–#11), tier-labeled; handoff folded into #8
Agent prompts updated: plan.md, residual.md, explore.md, review.md, docs.md, build.md, general.md — backlog = Forgejo issues; plan/build MCP intent expressed via prompt instructions
AGENTS.md §10.8 updated (backlog = issues; MCP scoping note)
10 .agent/plans/*.md deleted; committed (91d9afc, 18 files, -1573 lines)
Verified: 11 issues present with correct labels; core go build ./... + go test ./... PASS

Key finding: opencode 1.18.3 PermissionConfig has no mcp key — per-agent MCP tool scoping is NOT supported. Mode intent (plan = read + issue create/edit; build = + PRs) is enforced via prompt instructions only, documented in AGENTS.md §10.8.

Closing this tracking issue.

## Status update (2026-07-19) — DONE All steps complete: - [x] Tier labels created (tier-1-quick-win, tier-2-project, tier-3-sheets, tier-4-os, tier-4-infra, harness) - [x] Tracking issue #1 created - [x] 10 `.agent/plans/*.md` → 10 issues (#2–#11), tier-labeled; handoff folded into #8 - [x] Agent prompts updated: plan.md, residual.md, explore.md, review.md, docs.md, build.md, general.md — backlog = Forgejo issues; plan/build MCP intent expressed via prompt instructions - [x] AGENTS.md §10.8 updated (backlog = issues; MCP scoping note) - [x] 10 `.agent/plans/*.md` deleted; committed (91d9afc, 18 files, -1573 lines) - [x] Verified: 11 issues present with correct labels; `core` `go build ./...` + `go test ./...` PASS **Key finding:** opencode 1.18.3 `PermissionConfig` has no `mcp` key — per-agent MCP tool scoping is NOT supported. Mode intent (plan = read + issue create/edit; build = + PRs) is enforced via prompt instructions only, documented in AGENTS.md §10.8. Closing this tracking issue.

agent closed this issue

2026-07-19 02:35:51 +00:00