@akagilnc/pi-workflow-roles weekly downloads statistics

@akagilnc/pi-workflow-roles

Packaged workflow roles for Pi: judge, countersign, secretariat, gleaner-left, fixer, coder, reviewer, collector, doctor, merger, notary, inspector, diarist, analyst. 中文说明见 README.zh-CN.md。

Install

Installation policy: ADR 0052. Example:

pi install npm:@akagilnc/pi-workflow-roles
export PATH="$HOME/.pi/agent/npm/node_modules/.bin:$PATH"

Update example: pi update npm:@akagilnc/pi-workflow-roles. Inspect with ak-role roles and ak-role help <role>; seat and Gate-officer configuration lives under Reading results below.

Publish routing: registry workflow.

Reading results

Public entry and result delivery: ADR 0052. Example:

ak-role judge --model <provider/model[:thinking]> --attach ./plan.md "Review this plan." > result.txt

--attach, fixer --prerequisites, and collector --request-manifest pass the caller path as-is into the role's first message. The package does not read, copy, or validate the file; when the caller's cwd differs from --project, pass an absolute path (ADR 0087).

Exit status and Terminal semantics: ADR 0052, Terminal implementation.

Manual continuation and flag placement: ak-role help resume; model / host resolution: ak-role help; engine configuration: ak-role help config. Audit continuation: ADR 0003. Host switching and prior-record delivery: ADR 0086. Resume failure handling: public execution seam. Headless turn-input directory cleanup after a host terminal (or beside a setup failure that is rethrown) retains the cleanup cause via package-fault retention and continues; it does not invent a host failure or abort an already-formed terminal (headless host).

Automatic retry behavior: auto-resume implementation; configuration usage: ak-role help config; effective limit: ak-role config show.

Receipt re-requests and delivery accounting (#1132): role runtime, receipt delivery policy, external host loop. Unfinished-reason handling: ADR 0050.

Seat and Gate-officer configuration:

ak-role config set judge <provider/model[:thinking]>
# Gate-officer configuration examples
ak-role config set gatekeeper <provider/model[:thinking]>
ak-role config set inspector <provider/model[:thinking]>
ak-role config set notary <provider/model[:thinking]>
ak-role config unset gatekeeper
# Engine configuration examples
ak-role config set-engine judge claude-code
ak-role config set-engine coder cursor cursor-grok-4.6-high
ak-role config set-engine-model coder cursor-grok-4.6-high
ak-role config unset-engine-model coder
ak-role config unset-engine judge
# Host configuration examples
ak-role config set-host judge grok-build
ak-role config unset-host judge
ak-role config set-auto-resume-limit 3

Host axis: ak-role help; institutional boundaries: ADR 0082. Host recommendations and native compaction configuration: #971.

Host providers: ak-role help and provider resolution; table inspection: ak-role config show.

Machine method Skills: run ak-role setup; installation behavior: machine Skill setup, ADR 0052; host capabilities: Pi Skill delivery and external host descriptions.

Gate-officer resolution: institutional resolution; configuration usage: ak-role help config; persisted-file reading: config implementation.

Receipts: exported contracts; Navigator advice is a table lookup, not a model call: route table; invocation: ak-role help navigator. Composition and stopping: ADR 0010.

Submission gates: ADR 0079, submission gate, role gate composition and judge gates. Labor-engine failure policy: ADR 0071. Engine usage measurement: usage fact owner.…