@nk070281sjv/agents

@nk070281sjv/agents

Skill assets, reviewer personas, workflow references, and command definitions for the OpenCode-only OCR fork.

Purpose

This package is the source of truth for:

• SKILL.md and SKILL.uk.md
• review workflow references
• bundled reviewer personas
• default OCR config template
• installed /ocr-review command definition

The CLI copies these assets into a project's .ocr/ directory during ocr init / ocr update.

Install

The agents package is normally consumed through the CLI:

npm install -g @nk070281sjv/cli
ocr init

Package Layout

agents/
  skills/ocr/
    SKILL.md
    SKILL.uk.md
    references/
      workflow.md
      workflow.uk.md
      session-files.md
      session-state.md
      context-discovery.md
      final-template.md
      reviewers/
    assets/
      config.yaml
      reviewer-template.md
  commands/
    review.md

Installed Command Surface

This fork installs a single agent command:

• /ocr-review in OpenCode
• canonical source: .ocr/commands/review.md

Legacy agent command files were removed from this fork.

Bundled Reviewer Personas

The package ships these reviewer personas:

• architect
• database-administrator
• integration-api-contract-engineer
• java-spring-engineer
• performance
• qa-test-engineer
• security-engineer

Projects can add custom reviewers by placing extra markdown files into:

.ocr/skills/references/reviewers/

Process-Agent Review Model

This fork uses the CLI/OpenCode process-agent path:

1. CLI creates or resumes the OCR session
2. CLI prepares shared review context
3. CLI writes exact prompt snapshots for every reviewer
4. reviewer agents run in parallel as separate OpenCode processes
5. pipeline agents run aggregation, validation, synthesis, translation-uk
6. CLI verifies the artifact contract before marking the round complete

The parent agent must not fabricate reviewer outputs or skip configured reviewers.

Session Artifacts

Expected round artifacts:

.ocr/sessions/{session-id}/rounds/round-{n}/
  prompts/
  reviews/
  aggregation.md
  validation.md
  synthesis.md
  final.md
  final.uk.md

prompts/ stores exact sent prompts. reviews/ stores reviewer outputs.

Package Links

• Repository: gitlab.nk070281sjv.homes/market/services/open-code-review
• npm: @nk070281sjv/agents

License

Apache-2.0