Scan an Agentic System for Current Transfer
Type: types/instruction.md
Produce a selective current account of the external mechanisms that matter to a Commonplace question without changing the source-faithful external analysis or treating omitted differences as absent.
Prerequisites
- Use the analysis manifest and interest brief supplied in
$ARGUMENTS, the user request, or an invoking worker packet. If either cannot be identified unambiguously, stop and ask for the missing input. - One complete
analyse-agentic-systemset, entered throughkb/agentic-systems/reports/state/<run-id>/output/ARTIFACT.yaml, with its run’s../run-state.md. Bothrun-statusandresult-dispositionmust becomplete. The set is the authority for what the external system does: the overview holds the boundary, source register, amendment index, synthesis and limitations;runtime.mdthe runtime account and the records the runtime pass declared;memory.mdthe memory findings, memory-declared records and comparison profile;epistemic.mdthe five epistemic blocks;reconciliation.mdthe amendments, supersessions and unresolved conflicts. Do not reacquire or refresh its sources during this scan. - An explicit current question, design problem, or priority. A generic request to find every difference is not a valid brief. If the user asks broadly what is interesting, state the bounded standing concern you will use before selecting findings.
- Read access to the Commonplace artifacts needed to establish the current local analogue.
- Explicit file-output authority when the result should be written. Without it, return the scan in the response.
- A legacy memory review, compact public review, response, summary, or run ID alone is insufficient input, including for a response-only scan. Report the missing set or completion evidence; do not fall back to another analysis or produce transfer findings from the insufficient input.
Boundaries
This is an interest-conditioned transfer scan, not a complete delta. Omission means only not selected under this brief; it never means that the systems are identical on that point or that no other difference exists.
Do not edit the external analysis, its matrix fields, kb/agentic-systems/comparisons/memory-systems.csv, a public landscape analysis, or any Commonplace note, proposal, instruction, reference artifact, or implementation. Return promotion candidates to the caller; a later authorized operation decides their disposition.
Use Commonplace ontology to name mechanisms when the external analysis supports the mapping. Preserve the external system's native mechanism, the mapping rationale, and any qualification. Do not turn a partial analogy into identity.
Steps
- Verify the main-review input. From the repository root, run
commonplace-agentic-analysis-handoff <run-state-path>on the run state. Require exit status zero and substantive result dispositioncomplete; a completed blocked or out-of-scope run is not a transfer input. Require the supplied manifest path to matchrun-state.artifact.path. If the caller supplied a manifest SHA-256, require it to matchrun-state.artifact.sha256and the file's bytes. The handoff verifies the manifest; then read the overview and every member it pins: the evidence boundary and limitations in the overview, the relevant shared records in the runtime and memory members, and the lens findings in the memory and epistemic members, with amendments and unresolved conflicts in the reconciliation member. Any validation, identity, or completion failure stops the scan without findings; report the failure to the caller for correction through the main review workflow. - Fix the three substantive inputs and production provenance. Copy the
current interest brief exactly. Record the run ID, run-state path, source
identity and reviewed boundary, and the manifest's path, byte length, and
SHA-256; the manifest pins every member. Identify only the Commonplace
artifacts actually
consulted and record each path and SHA-256. Also record
scan-agentic-system-transferas the producing instruction and record model or runner provenance only when the harness supplies it; never infer missing provenance. - Establish the current analogue. Read the minimum Commonplace system-definition and knowledge artifacts needed to answer the brief. Distinguish shipped behavior from proposals, notes, and work in progress. Do not use a proposal or note as evidence that Commonplace already implements a mechanism.
- Select, do not enumerate. Choose zero to five differences, tensions, confirmations, or implementation variants that could change the current decision. Prefer mechanisms with a named consequence over attractive features. A similarity belongs only when it confirms or challenges a live choice. If nothing clears that threshold, return a valid zero-finding scan.
- Write each finding as a transfer candidate. Include:
- the external mechanism and its evidence-bearing member, section and canonical record IDs in the set, preserving its conclusion status and inspected boundary;
- the Commonplace ontology mapping and why it fits, including
partialoruncertainwhen needed; - the current Commonplace analogue, with the consulted artifact path;
- the selected difference or confirmation;
- why it matters under this interest brief now;
- the smallest consequence worth considering; and
- a disposition:
promote candidate,proposal candidate,experiment candidate,watch under this brief, orno action. - Recheck the inputs. Immediately before returning findings or writing state, repeat step 0 and recompute the manifest and consulted-Commonplace fingerprints. If validation fails, withhold the findings and report the blocker. If any fingerprint or the interest brief changed, discard the draft and restart from step 0 against the newly identified inputs.
- Route the living result. Return response-only unless the caller authorized a state output. Written scans live under
kb/reports/state/agentic-system-transfer/because their LLM judgments and unresolved candidate dispositions are not reproducible cache. Use a filename that combines the system and an interest-brief slug. A scan becomes stale when the manifest digest changes, any consulted Commonplace artifact changes, or the interest brief changes. Do not overwrite or delete an open scan merely because it is stale: first recordno action, promote each accepted consequence through a separately authorized operation, or receive explicit discard authority. Until then, write the new scan to a collision-safe sibling and mark the prior path as superseded when authorized. After every candidate has a durable disposition elsewhere orno action, the owning workflow may replace or delete the state report.
Output
Open with:
subject | analysis run ID and run-state path | source identity and reviewed boundary | manifest path, byte length, and SHA-256 | interest brief | consulted Commonplace paths and hashes | producing instruction | harness-supplied model/runner or not supplied | generated date | selective/non-exhaustive: yes
Then give the selected findings and finish with:
- promotion candidates, if any;
- unresolved evidence limits; and
- the three invalidation conditions above; and
- whether every candidate is disposed and the state is therefore safe to replace or delete.
Do not add a difference count, coverage percentage, or claim that the scan exhausts the external analysis.
Verify
- Initial and final completion/identity checks passed for the same manifest.
- Every external-system claim resolves to a member's findings and canonical records. No legacy review or compact summary supplied a finding, and no conclusion status or absence claim was inferred from omission.
- Every statement about current Commonplace resolves to a consulted artifact and distinguishes implemented behavior from proposed or explanatory material.
- Every ontology mapping includes a reason and preserves partial or uncertain fit.
- Every selected finding states why it matters under the recorded brief; generic admiration is absent.
- Omission carries no negative meaning, the result feeds no matrix or public corpus statistic, and no candidate was promoted automatically.
- A response or written result records the manifest fingerprint, all three freshness inputs, run and production provenance, and the successful final input recheck. A written result also records the cleanup condition.