@fro.bot/systematic 3.24.2 → 3.25.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/HARNESSES.md +18 -11
  2. package/dist/cli.js +305 -186
  3. package/dist/{index-vkmdceqk.js → index-bmsgc2em.js} +9 -10
  4. package/dist/index.js +1 -1
  5. package/dist/lib/config.d.ts +23 -7
  6. package/dist/lib/pi-subagents-export.d.ts +40 -7
  7. package/dist/lib/pi-subagents-personas.d.ts +9 -0
  8. package/dist/pi-subagents/agents/systematic-adversarial-document-reviewer.md +87 -0
  9. package/dist/pi-subagents/agents/systematic-adversarial-reviewer.md +102 -0
  10. package/dist/pi-subagents/agents/systematic-api-contract-reviewer.md +43 -0
  11. package/dist/pi-subagents/agents/systematic-architecture-strategist.md +50 -0
  12. package/dist/pi-subagents/agents/systematic-best-practices-researcher.md +112 -0
  13. package/dist/pi-subagents/agents/systematic-bug-reproduction-validator.md +88 -0
  14. package/dist/pi-subagents/agents/systematic-cli-readiness-reviewer.md +65 -0
  15. package/dist/pi-subagents/agents/systematic-code-simplicity-reviewer.md +84 -0
  16. package/dist/pi-subagents/agents/systematic-coherence-reviewer.md +37 -0
  17. package/dist/pi-subagents/agents/systematic-correctness-reviewer.md +43 -0
  18. package/dist/pi-subagents/agents/systematic-data-migrations-reviewer.md +47 -0
  19. package/dist/pi-subagents/agents/systematic-deployment-verification-agent.md +157 -0
  20. package/dist/pi-subagents/agents/systematic-design-lens-reviewer.md +44 -0
  21. package/dist/pi-subagents/agents/systematic-feasibility-reviewer.md +40 -0
  22. package/dist/pi-subagents/agents/systematic-framework-docs-researcher.md +91 -0
  23. package/dist/pi-subagents/agents/systematic-git-history-analyzer.md +44 -0
  24. package/dist/pi-subagents/agents/systematic-issue-intelligence-analyst.md +207 -0
  25. package/dist/pi-subagents/agents/systematic-maintainability-reviewer.md +43 -0
  26. package/dist/pi-subagents/agents/systematic-pattern-recognition-specialist.md +55 -0
  27. package/dist/pi-subagents/agents/systematic-performance-reviewer.md +45 -0
  28. package/dist/pi-subagents/agents/systematic-previous-comments-reviewer.md +59 -0
  29. package/dist/pi-subagents/agents/systematic-product-lens-reviewer.md +68 -0
  30. package/dist/pi-subagents/agents/systematic-reliability-reviewer.md +43 -0
  31. package/dist/pi-subagents/agents/systematic-repo-research-analyst.md +322 -0
  32. package/dist/pi-subagents/agents/systematic-scope-guardian-reviewer.md +52 -0
  33. package/dist/pi-subagents/agents/systematic-security-lens-reviewer.md +36 -0
  34. package/dist/pi-subagents/agents/systematic-security-reviewer.md +45 -0
  35. package/dist/pi-subagents/agents/systematic-spec-flow-analyzer.md +82 -0
  36. package/dist/pi-subagents/agents/systematic-testing-reviewer.md +43 -0
  37. package/dist/pi.js +186 -12
  38. package/package.json +13 -5
  39. package/skills/using-systematic/references/pi-profile.md +12 -8
package/dist/pi.js CHANGED
@@ -10746,19 +10746,18 @@ function sortAuthorities(authorities) {
10746
10746
  function sortProtectedFields(fields) {
10747
10747
  return [...fields].sort((left, right) => left.fieldPath === right.fieldPath ? left.sourceKind.localeCompare(right.sourceKind) : left.fieldPath.localeCompare(right.fieldPath));
10748
10748
  }
10749
+ function isAgentDisabled(disabledAgents, agentOverlays, category, key) {
10750
+ const qualifiedId = category ? `${category}/${key}` : key;
10751
+ if (disabledAgents.has(key) || disabledAgents.has(qualifiedId))
10752
+ return true;
10753
+ return agentOverlays[key]?.value.disable === true || agentOverlays[qualifiedId]?.value.disable === true;
10754
+ }
10749
10755
  function collectRoutingTargets(overlays, disabledAgents = new Set) {
10750
10756
  const targets = new Map;
10751
- const isDisabled = (agentKey, category) => {
10752
- const qualifiedId = `${category}/${agentKey}`;
10753
- if (disabledAgents.has(agentKey) || disabledAgents.has(qualifiedId)) {
10754
- return true;
10755
- }
10756
- const overlay = overlays.agents[agentKey]?.value ?? overlays.agents[qualifiedId]?.value;
10757
- return overlay?.disable === true;
10758
- };
10759
10757
  const addTarget = (agentKey, category) => {
10760
- if (isDisabled(agentKey, category))
10758
+ if (isAgentDisabled(disabledAgents, overlays.agents, category, agentKey)) {
10761
10759
  return;
10760
+ }
10762
10761
  targets.set(`${category}/${agentKey}`, { agentKey, category });
10763
10762
  };
10764
10763
  for (const rawKey of Object.keys(overlays.agents)) {
@@ -11447,6 +11446,138 @@ function createDelegateSessionWith(runtime) {
11447
11446
  }
11448
11447
  var createRealPiDelegateSession = createDelegateSessionWith(REAL_PI_DELEGATE_SESSION_RUNTIME);
11449
11448
 
11449
+ // src/lib/pi-subagents-personas.ts
11450
+ var CURATED_PERSONAS = [
11451
+ {
11452
+ relPath: "agents/research/best-practices-researcher.md",
11453
+ rationale: "Self-contained research persona. INFO: mentions skills in prose as discovery hints, but is operationally independent — no load-skill directive, no parent-dispatch assumption."
11454
+ },
11455
+ {
11456
+ relPath: "agents/research/framework-docs-researcher.md",
11457
+ rationale: "Self-contained framework documentation researcher. No Systematic-only coupling; uses standard tools (Context7, web search, file reads)."
11458
+ },
11459
+ {
11460
+ relPath: "agents/research/git-history-analyzer.md",
11461
+ rationale: "Self-contained git archaeology persona. Uses only standard git CLI + file tools. No skill or orchestration dependencies."
11462
+ },
11463
+ {
11464
+ relPath: "agents/research/issue-intelligence-analyst.md",
11465
+ rationale: "Self-contained GitHub issue analysis persona. Requires only gh CLI + standard file tools. No Systematic-only coupling."
11466
+ },
11467
+ {
11468
+ relPath: "agents/research/repo-research-analyst.md",
11469
+ rationale: "Self-contained repository research persona. Uses standard file/search/glob tools. No Systematic-specific orchestration."
11470
+ },
11471
+ {
11472
+ relPath: "agents/review/adversarial-reviewer.md",
11473
+ rationale: "Self-contained adversarial code reviewer. Fully portable — no Systematic tools or skills required."
11474
+ },
11475
+ {
11476
+ relPath: "agents/review/api-contract-reviewer.md",
11477
+ rationale: "Self-contained API contract reviewer. No Systematic-only coupling."
11478
+ },
11479
+ {
11480
+ relPath: "agents/review/architecture-strategist.md",
11481
+ rationale: "Self-contained architectural reviewer. No Systematic-only coupling."
11482
+ },
11483
+ {
11484
+ relPath: "agents/review/cli-readiness-reviewer.md",
11485
+ rationale: "Self-contained CLI readiness reviewer. No Systematic-only coupling."
11486
+ },
11487
+ {
11488
+ relPath: "agents/review/code-simplicity-reviewer.md",
11489
+ rationale: "Self-contained code simplicity reviewer. No Systematic-only coupling."
11490
+ },
11491
+ {
11492
+ relPath: "agents/review/correctness-reviewer.md",
11493
+ rationale: "Self-contained correctness reviewer. No Systematic-only coupling."
11494
+ },
11495
+ {
11496
+ relPath: "agents/review/data-migrations-reviewer.md",
11497
+ rationale: "Self-contained data migrations reviewer. No Systematic-only coupling."
11498
+ },
11499
+ {
11500
+ relPath: "agents/review/deployment-verification-agent.md",
11501
+ rationale: "Self-contained deployment verification persona. No Systematic-only coupling."
11502
+ },
11503
+ {
11504
+ relPath: "agents/review/maintainability-reviewer.md",
11505
+ rationale: "Self-contained maintainability reviewer. No Systematic-only coupling."
11506
+ },
11507
+ {
11508
+ relPath: "agents/review/pattern-recognition-specialist.md",
11509
+ rationale: "Self-contained pattern recognition reviewer. No Systematic-only coupling."
11510
+ },
11511
+ {
11512
+ relPath: "agents/review/performance-reviewer.md",
11513
+ rationale: "Self-contained performance reviewer. No Systematic-only coupling."
11514
+ },
11515
+ {
11516
+ relPath: "agents/review/previous-comments-reviewer.md",
11517
+ rationale: "Self-contained previous-comments reviewer. Reviews prior feedback. No Systematic-only coupling."
11518
+ },
11519
+ {
11520
+ relPath: "agents/review/reliability-reviewer.md",
11521
+ rationale: "Self-contained reliability reviewer. No Systematic-only coupling."
11522
+ },
11523
+ {
11524
+ relPath: "agents/review/security-reviewer.md",
11525
+ rationale: "Self-contained security reviewer. No Systematic-only coupling."
11526
+ },
11527
+ {
11528
+ relPath: "agents/review/testing-reviewer.md",
11529
+ rationale: "Self-contained testing reviewer. No Systematic-only coupling."
11530
+ },
11531
+ {
11532
+ relPath: "agents/document-review/adversarial-document-reviewer.md",
11533
+ rationale: "Self-contained document reviewer. Challenges premises in plans/specs. No Systematic-only coupling."
11534
+ },
11535
+ {
11536
+ relPath: "agents/document-review/coherence-reviewer.md",
11537
+ rationale: "Self-contained document coherence reviewer. No Systematic-only coupling."
11538
+ },
11539
+ {
11540
+ relPath: "agents/document-review/design-lens-reviewer.md",
11541
+ rationale: "Self-contained design lens reviewer. No Systematic-only coupling."
11542
+ },
11543
+ {
11544
+ relPath: "agents/document-review/feasibility-reviewer.md",
11545
+ rationale: "Self-contained feasibility reviewer. No Systematic-only coupling."
11546
+ },
11547
+ {
11548
+ relPath: "agents/document-review/product-lens-reviewer.md",
11549
+ rationale: "Self-contained product lens reviewer. No Systematic-only coupling."
11550
+ },
11551
+ {
11552
+ relPath: "agents/document-review/scope-guardian-reviewer.md",
11553
+ rationale: "Self-contained scope guardian reviewer. No Systematic-only coupling."
11554
+ },
11555
+ {
11556
+ relPath: "agents/document-review/security-lens-reviewer.md",
11557
+ rationale: "Self-contained security lens reviewer. No Systematic-only coupling."
11558
+ },
11559
+ {
11560
+ relPath: "agents/workflow/spec-flow-analyzer.md",
11561
+ rationale: "Self-contained spec flow analyzer. Analyzes specs for user flow completeness. No Systematic orchestration coupling."
11562
+ },
11563
+ {
11564
+ relPath: "agents/workflow/bug-reproduction-validator.md",
11565
+ rationale: "Self-contained bug reproduction specialist. WARNING: mentions agent-browser skill in prose as an optional tool hint, but does not require Systematic skill loading to operate."
11566
+ }
11567
+ ];
11568
+ function parseSourceCategoryAndKey(sourceRelPath) {
11569
+ const parts = sourceRelPath.split("/");
11570
+ if (parts.length >= 3 && parts[0] === "agents") {
11571
+ const fileName = parts.at(-1) ?? "";
11572
+ return {
11573
+ category: parts[1],
11574
+ agentKey: fileName.replace(/\.md$/, "")
11575
+ };
11576
+ }
11577
+ const fileName = parts.at(-1) ?? sourceRelPath;
11578
+ return { category: undefined, agentKey: fileName.replace(/\.md$/, "") };
11579
+ }
11580
+
11450
11581
  // src/lib/skill-resolver.ts
11451
11582
  import fs7 from "node:fs";
11452
11583
  import path6 from "node:path";
@@ -11750,18 +11881,60 @@ var reportPiDelegateCatalogFailure = (error) => {
11750
11881
  process.stderr.write(`[systematic] Failed to build Pi agent catalog; systematic_delegate will not be registered: ${message}
11751
11882
  `);
11752
11883
  };
11884
+ var PACKAGED_OVERLAY_WARNING = "[systematic] systematic.json configures agent or pi_subagents overlays (model, thinking, max_turns, tools or skills). " + "Personas packaged with Systematic ignore overlays; they load with pi-subagents' defaults. " + "Run `systematic pi-subagents export` to write overlay-aware persona files, which outrank the packaged ones.\n";
11885
+ var reportPackagedOverlayIgnored = () => {
11886
+ process.stderr.write(PACKAGED_OVERLAY_WARNING);
11887
+ };
11888
+ var reportPackagedPersonasStillLoad = (count) => {
11889
+ process.stderr.write(`[systematic] ${count} persona(s) disabled in systematic.json still load in pi-subagents from the Systematic package, ` + "which has no access to that setting. " + "To stop them loading, disable one with /agents → Disable, or set `packageAgents: false` in subagents.json to turn off every packaged persona. " + `This notice repeats on each start while the setting is present, because Systematic cannot read pi-subagents' own settings.
11890
+ `);
11891
+ };
11892
+ var WARNINGS_EMITTED_KEY = Symbol.for("systematic.pi.packagedWarningsEmitted");
11893
+ function claimPackagedWarnings() {
11894
+ if (Reflect.get(globalThis, WARNINGS_EMITTED_KEY) === true)
11895
+ return false;
11896
+ Reflect.set(globalThis, WARNINGS_EMITTED_KEY, true);
11897
+ return true;
11898
+ }
11899
+ var PI_CONSUMED_ROUTING_FIELDS = ["model", "pi"];
11900
+ function hasPiConsumedRoutingField(overlays) {
11901
+ return Object.values(overlays).some(({ value }) => PI_CONSUMED_ROUTING_FIELDS.some((field) => Object.hasOwn(value, field)));
11902
+ }
11903
+ function hasOverlaysPackagedPersonasIgnore(routing, piSubagents) {
11904
+ return hasPiConsumedRoutingField(routing.agents) || hasPiConsumedRoutingField(routing.categories) || hasNonEmptyEntry(piSubagents?.agents) || hasNonEmptyEntry(piSubagents?.categories);
11905
+ }
11906
+ function hasNonEmptyEntry(entries) {
11907
+ return Object.values(entries ?? {}).some((entry) => Object.keys(entry).length > 0);
11908
+ }
11909
+ function countDisabledPackagedPersonas(config, routing) {
11910
+ const disabledAgents = new Set(config.disabled_agents);
11911
+ return CURATED_PERSONAS.filter((persona) => {
11912
+ const { category, agentKey } = parseSourceCategoryAndKey(persona.relPath);
11913
+ return isAgentDisabled(disabledAgents, routing.agents, category ?? "", agentKey);
11914
+ }).length;
11915
+ }
11753
11916
  var defaultPiExtensionDependencies = {
11754
11917
  buildAgentCatalog
11755
11918
  };
11756
11919
  async function systematicPiExtension(pi, deps = defaultPiExtensionDependencies) {
11757
11920
  const { buildAgentCatalog: buildAgentCatalogFn = buildAgentCatalog } = deps;
11758
- const disabledSkills = [];
11759
- const resolverOptions = { bundledSkillsDir, disabledSkills };
11760
11921
  const {
11761
11922
  config: piConfig,
11762
11923
  metadata: piConfigMetadata,
11763
11924
  overlays: piRoutingOverlays
11764
11925
  } = loadConfigWithSources(process.cwd());
11926
+ const overlaysIgnored = hasOverlaysPackagedPersonasIgnore(piRoutingOverlays, piConfig.pi_subagents);
11927
+ const disabledPackaged = countDisabledPackagedPersonas(piConfig, piRoutingOverlays);
11928
+ if ((overlaysIgnored || disabledPackaged > 0) && claimPackagedWarnings()) {
11929
+ if (overlaysIgnored)
11930
+ reportPackagedOverlayIgnored();
11931
+ if (disabledPackaged > 0)
11932
+ reportPackagedPersonasStillLoad(disabledPackaged);
11933
+ }
11934
+ const resolverOptions = {
11935
+ bundledSkillsDir,
11936
+ disabledSkills: piConfig.disabled_skills
11937
+ };
11765
11938
  const bootstrapContent = computeBootstrapContentSafe({
11766
11939
  bundledSkillsDir,
11767
11940
  usageTemplate: PI_BOOTSTRAP_USAGE_TEMPLATE,
@@ -11793,7 +11966,8 @@ async function systematicPiExtension(pi, deps = defaultPiExtensionDependencies)
11793
11966
  }
11794
11967
  });
11795
11968
  try {
11796
- const catalog = buildAgentCatalogFn(bundledAgentsDir);
11969
+ const disabledAgents = new Set(piConfig.disabled_agents);
11970
+ const catalog = buildAgentCatalogFn(bundledAgentsDir).filter((entry) => !isAgentDisabled(disabledAgents, piRoutingOverlays.agents, entry.category, entry.key));
11797
11971
  pi.registerTool(createPiDelegateTool({
11798
11972
  catalog,
11799
11973
  createDelegateSession: createRealPiDelegateSession,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fro.bot/systematic",
3
- "version": "3.24.2",
3
+ "version": "3.25.1",
4
4
  "description": "Compound-engineering loops for OpenCode, Pi, and Claude Code",
5
5
  "type": "module",
6
6
  "homepage": "https://fro.bot/systematic",
@@ -20,7 +20,12 @@
20
20
  ],
21
21
  "skills": [
22
22
  "./skills"
23
- ]
23
+ ],
24
+ "subagents": {
25
+ "agents": [
26
+ "./dist/pi-subagents/agents"
27
+ ]
28
+ }
24
29
  },
25
30
  "files": [
26
31
  "dist",
@@ -34,7 +39,7 @@
34
39
  ],
35
40
  "scripts": {
36
41
  "clean": "rimraf dist",
37
- "build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --splitting --external @opencode-ai/plugin --external js-yaml && bun build src/pi.ts --outdir dist --target node --external @earendil-works/pi-coding-agent --external typebox --external jsonc-parser && tsc --emitDeclarationOnly",
42
+ "build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --splitting --external @opencode-ai/plugin --external js-yaml && bun build src/pi.ts --outdir dist --target node --external @earendil-works/pi-coding-agent --external typebox --external jsonc-parser && tsc --emitDeclarationOnly && bun scripts/build-pi-package-agents.ts",
38
43
  "dev": "bun --watch src/index.ts",
39
44
  "test": "bun test tests/unit",
40
45
  "test:integration": "bun test tests/integration",
@@ -69,7 +74,8 @@
69
74
  "plugin",
70
75
  "ai",
71
76
  "workflow",
72
- "engineering"
77
+ "engineering",
78
+ "pi-package"
73
79
  ],
74
80
  "author": "Marcus R. Brown <human@fro.bot>",
75
81
  "license": "MIT",
@@ -128,8 +134,10 @@
128
134
  "conventional-changelog-writer": ">=9",
129
135
  "devalue": "^5.9.3",
130
136
  "fast-uri": "~3.1.7",
137
+ "markdown-it": "~14.3.3",
131
138
  "smol-toml": "~1.9.0",
132
- "source-map-js": "^1.2.2"
139
+ "source-map-js": "^1.2.2",
140
+ "vite": "~8.3.0"
133
141
  },
134
142
  "publishConfig": {
135
143
  "access": "public",
@@ -4,7 +4,7 @@ Evidence registry: see [`HARNESSES.md`](../../../HARNESSES.md).
4
4
 
5
5
  | Capability | Mechanism | Status | Fallback |
6
6
  |---|---|---|---|
7
- | Subagent delegation | Bounded built-in delegate via `systematic_delegate({agent, task})`; optional mature delegation via [pi-subagents](https://github.com/tintinweb/pi-subagents) through opt-in persona export | built-in: degraded (sequential only); pi-subagents path: outside Systematic's bounded-delegate guarantees | Dispatch sequentially in dependency order or do the work inline |
7
+ | Subagent delegation | Bounded built-in delegate via `systematic_delegate({agent, task})`; optional mature delegation via [pi-subagents](https://github.com/tintinweb/pi-subagents): installed package personas, opt-in export for overlays | built-in: degraded (sequential only); pi-subagents path: outside Systematic's bounded-delegate guarantees | Dispatch sequentially in dependency order or do the work inline |
8
8
  | Blocking user interaction | No native blocking tool | degraded | Present numbered options in chat and wait |
9
9
  | Task tracking | No native task-tracking mechanism | unavailable | Maintain a visible task list in responses |
10
10
  | Skill loading | `systematic_skill` tool or Pi-native skill activation | supported | Read the skill instructions listed by the active harness |
@@ -15,18 +15,24 @@ Evidence registry: see [`HARNESSES.md`](../../../HARNESSES.md).
15
15
 
16
16
  ```typescript
17
17
  systematic_delegate({
18
- agent: "systematic-implementer",
19
- task: "Implement the auth module and return the changed files.",
18
+ agent: "repo-research-analyst",
19
+ task: "Map how the auth module is wired and list the files involved.",
20
20
  })
21
21
  ```
22
22
 
23
+ `systematic_delegate` takes the bare name; the pi-subagents `Agent` tool takes `systematic-<name>`.
24
+
23
25
  `systematic_delegate` is sequential, capped at 20 turns, depth-1, and spawns its child with `noExtensions: true`. The `noExtensions` guarantee bounds `systematic_delegate`'s own recursion — it does not bound end-to-end delegation depth across a combined pi-subagents + Systematic path.
24
26
 
25
27
  ### Optional: pi-subagents delegation
26
28
 
27
- Export Systematic personas for use with [pi-subagents](https://github.com/tintinweb/pi-subagents) (parallel/multi-model delegation). All writes are opt-in; nothing is exported at extension load.
29
+ [pi-subagents](https://github.com/tintinweb/pi-subagents) (parallel/multi-model delegation) 0.22 or newer loads 29 curated personas from the installed package as `systematic-<name>` agent types with plain defaults; a project-scope install only after the project is trusted, and its first session may omit them from the `Agent` description, though dispatch works. Any other type falls back to `general-purpose` with an "Unknown agent type" note: the persona did not run. Export is needed only to apply `systematic.json` overlays; a local file outranks the packaged one. Nothing is written at extension load.
30
+
31
+ `disabled_agents` and `agents.<name>.disable` do not reach packaged personas. Turn one off with `/agents → Disable`, or all with `packageAgents: false` in `subagents.json`.
28
32
 
29
- Tested against pi-subagents v0.14.3 (verified contract as of July 29, 2026). Versions outside the tested range are unsupported but nonfatal.
33
+ The `Agent` tool runs in the background by default. Pass `run_in_background: false` to wait for the result.
34
+
35
+ Tested against pi-subagents 0.22.0 on Pi 1.3.0. Versions outside the tested range are unsupported but nonfatal.
30
36
 
31
37
  Exact CLI form: `systematic pi-subagents <preview|export|refresh|cleanup> --scope project|global`. `--scope` is optional and defaults to `project`.
32
38
 
@@ -42,9 +48,7 @@ systematic pi-subagents cleanup [--scope project|global]
42
48
 
43
49
  The pi-subagents delegation path is **outside Systematic's bounded-delegate guarantees** and governed by pi-subagents' own configuration. `systematic_delegate` remains the bounded default.
44
50
 
45
- `export`/`refresh`/`cleanup` hold an exclusive per-root mutation lock and fail closed if any path component between the selected scope's anchor and the agents directory is a symlink or not a directory. A manifest (`.systematic-personas.json`) tracks ownership by filename and content hash; cleanup and stale-file removal only delete a file whose on-disk content still matches its recorded hash, refusing otherwise. Manifest hashes are drift evidence, not a cryptographic authenticity guarantee.
46
-
47
- Systematic's own config (`systematic.json`/`.jsonc`) is the durable source of truth for exported personas; the generated files and their manifest are a disposable projection that `export`/`refresh`/`cleanup` regenerate or remove, and `refresh` intentionally overwrites manifest-owned generated files that diverge from current config — run `preview` first to see what would change. See the [pi-subagents pairing guide](https://fro.bot/systematic/guides/pi-subagents/) for the config precedence, trust boundaries, and a canonical example.
51
+ Locking, ownership, config precedence and trust boundaries: see [`HARNESSES.md`](../../../HARNESSES.md) and the [pi-subagents pairing guide](https://fro.bot/systematic/guides/pi-subagents/).
48
52
 
49
53
  ### Blocking user interaction
50
54