@markjaquith/agency 2.41.0 → 2.43.0

package/README.md

@@ -51,7 +51,7 @@ workbase/
   .agency/
     AGENTS.md              # managed Agency instructions
   .opencode/
-    opencode.jsonc         # managed instructions and whole-workbase reference
+    opencode.jsonc         # managed @agency subagent, instructions, and reference
   agency.json              # tracked config and portable repository declarations
   repos/                   # ignored local materializations
     frontend/              # bare Git repository or symlink
@@ -90,11 +90,14 @@ Agency-managed root `AGENTS.md` to `.agency/AGENTS.md` once the OpenCode config
 can load the hidden file. A customized root file, including a symlink, is
 preserved as user-owned content.
 
-The OpenCode config loads Agency's hidden instructions in addition to any
-user-owned root `AGENTS.md` and advertises the complete workbase as one portable
-reference. OpenCode discovers that config from task and epic launch directories.
-Agents receive whole-workbase visibility from that reference. Bash and Agency
-operations must still follow the write authority reported by `agency context`.
+The OpenCode config defines an `@agency` subagent for delegated workbase
+orchestration, loads Agency's hidden instructions in addition to any user-owned
+root `AGENTS.md`, advertises the complete workbase as one portable reference,
+and replaces the built-in Plan agent with `agency-plan`. That planning agent can
+update `TASK.md`, `PHASE.md`, and `EPIC.md` while other edits remain disabled.
+OpenCode discovers the config from task and epic launch directories. Agents
+receive whole-workbase visibility from that reference. Bash and Agency operations
+must still follow the write authority reported by `agency context`.
 
 OpenCode also discovers a managed `/agency` command. Use `/agency status` for a
 read-only current-work summary, `/agency start [target]` to begin or resume work

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markjaquith/agency",
-  "version": "2.41.0",
+  "version": "2.43.0",
   "description": "Manage agentic work across repositories with durable workbases",
   "keywords": [
     "agents",

package/src/cli.test.ts

@@ -1059,13 +1059,32 @@ status: open
 						env: environment,
 					})
 					expect(configProbe.exitCode).toBe(0)
-					expect(JSON.parse(configProbe.stdout.toString()).references).toEqual({
+					const effectiveConfig = JSON.parse(configProbe.stdout.toString())
+					expect(effectiveConfig.agent.agency).toMatchObject({
+						description: expect.stringContaining(
+							"Agency workbase orchestration",
+						),
+						mode: "subagent",
+					})
+					expect(effectiveConfig.references).toEqual({
 						workbase: {
 							path: "..",
 							description:
 								"Complete Agency workbase context; write authority still comes only from agency context",
 						},
 					})
+					const agencyProbe = Bun.spawnSync(
+						["opencode", "debug", "agent", "agency"],
+						{ cwd: contract.cwd, env: environment },
+					)
+					expect(agencyProbe.exitCode).toBe(0)
+					expect(JSON.parse(agencyProbe.stdout.toString())).toMatchObject({
+						name: "agency",
+						description: expect.stringContaining(
+							"Agency workbase orchestration",
+						),
+						mode: "subagent",
+					})
 					for (const document of documents) {
 						const read = Bun.spawnSync(
 							[

package/src/commands/init.test.ts

@@ -40,6 +40,23 @@ describe("init command", () => {
 		).text()
 		const config = JSON.parse(opencode.slice(opencode.indexOf("\n\n") + 2))
 		expect(config.instructions).toEqual([".agency/AGENTS.md"])
+		expect(config.agent.agency).toMatchObject({
+			description: expect.stringContaining("Agency workbase orchestration"),
+			mode: "subagent",
+			prompt: expect.stringContaining("agency context . --json"),
+		})
+		expect(config.agent.plan).toEqual({ disable: true })
+		expect(config.agent["agency-plan"]).toMatchObject({
+			mode: "primary",
+			permission: {
+				edit: {
+					"*": "deny",
+					"tasks/*/TASK.md": "allow",
+					"tasks/*/phases/*/PHASE.md": "allow",
+					"epics/*/EPIC.md": "allow",
+				},
+			},
+		})
 		expect(config.references).toEqual({
 			workbase: expect.objectContaining({ path: ".." }),
 		})

package/src/services/IntegrationService.test.ts

@@ -138,10 +138,40 @@ describe("IntegrationService", () => {
 		expect(body).toContain(".opencode/command/agency.md")
 	})
 
-	test("grants OpenCode access to the complete workbase", () => {
+	test("configures Agency agents with complete workbase access", () => {
 		const config = JSON.parse(managedBody(managedWorkbaseOpencode))
 
 		expect(config.instructions).toEqual([".agency/AGENTS.md"])
+		expect(config.agent).toEqual({
+			agency: {
+				description:
+					"Handles Agency workbase orchestration and workflow operations with the Agency CLI",
+				mode: "subagent",
+				prompt: expect.stringContaining("agency context . --json"),
+			},
+			plan: {
+				disable: true,
+			},
+			"agency-plan": {
+				description:
+					"Agency planning mode. May edit only Agency planning documents.",
+				mode: "primary",
+				prompt: expect.stringContaining("You are in Agency Plan mode"),
+				permission: {
+					question: "allow",
+					edit: {
+						"*": "deny",
+						"tasks/*/TASK.md": "allow",
+						"tasks/*/phases/*/PHASE.md": "allow",
+						"epics/*/EPIC.md": "allow",
+					},
+				},
+			},
+		})
+		expect(config.agent.agency.model).toBeUndefined()
+		expect(config.agent.agency.permission).toBeUndefined()
+		expect(config.agent.agency.hidden).toBeUndefined()
+		expect(config.agent.agency.steps).toBeUndefined()
 		expect(config.references).toEqual({
 			workbase: {
 				path: "..",

package/src/workbase/opencode-file.ts

@@ -6,11 +6,42 @@ const managedHeaderPattern =
 const checksum = (content: string) =>
 	createHash("sha256").update(content).digest("hex")
 
+const agencyPlanPrompt = `You are in Agency Plan mode. Think, read, search, and delegate exploration to construct a well-formed plan for the user's goal. Keep the plan comprehensive but concise, and ask clarifying questions when important tradeoffs or intent are unclear.
+
+You may edit TASK.md, PHASE.md, and EPIC.md to record the outcome, current approach, and important decisions. Do not edit any other file or use shell commands to modify the system.`
+
 const body = () =>
 	`${JSON.stringify(
 		{
 			$schema: "https://opencode.ai/config.json",
 			instructions: [".agency/AGENTS.md"],
+			agent: {
+				agency: {
+					description:
+						"Handles Agency workbase orchestration and workflow operations with the Agency CLI",
+					mode: "subagent",
+					prompt:
+						"You are the Agency workflow specialist. Use the Agency CLI to handle delegated workbase orchestration and workflow operations. Always start with `agency context . --json`, follow the managed Agency instructions and reported authority, use Agency commands for durable mutations, and report the resulting state concisely.",
+				},
+				plan: {
+					disable: true,
+				},
+				"agency-plan": {
+					description:
+						"Agency planning mode. May edit only Agency planning documents.",
+					mode: "primary",
+					prompt: agencyPlanPrompt,
+					permission: {
+						question: "allow",
+						edit: {
+							"*": "deny",
+							"tasks/*/TASK.md": "allow",
+							"tasks/*/phases/*/PHASE.md": "allow",
+							"epics/*/EPIC.md": "allow",
+						},
+					},
+				},
+			},
 			references: {
 				workbase: {
 					path: "..",