jiang-autonomous-work-protocol

name	jiang-autonomous-work-protocol
description	Use this skill when a Jiang Lens autonomous agent needs to discover, claim, perform, validate, and hand off repo work without overwriting other agents or confusing authored, raw, and generated artifacts.

Jiang Autonomous Work Protocol

Use this as shared operating hygiene for autonomous Jiang Lens agents. This is not an orchestrator and not a persona. It is the minimum protocol for doing independent repo work safely.

Authority

• content/ is canonical project state.
• ops/ contains tooling, schemas, scripts, notebooks, and local staging caches.
• website/ renders the public site.
• Generated files under website/src/content/docs/generated/, website/src/data/lens/, and content/_generated/ are compiler outputs.
• Never commit cookies, browser profiles, tokens, raw audio, or raw video.

Work Discovery

Prefer explicit user instructions. If none exist, discover work from deterministic repo state:

• Ready raw-source videos: node ops/scripts/build-episode-backlog.mjs --channel @PredictiveHistory
• Existing source tasks: content/workflow/tasks/<source-slug>/
• Existing proposals: content/workflow/proposals/
• Existing public episode reads: content/lens/episodes/<source-slug>/read.json
• Existing lens docs: website/src/content/docs/lens*.md

Before editing, inspect git status --short. Treat unknown changes as another agent's or maintainer's work. Do not revert them.

The source backlog already applies content/workflow/tasks/source-processing-policy.json. Claim only rows whose processable field is true. A duplicate, blocked, skipped, or archive-only raw artifact is not a source-production task unless the maintainer explicitly asks for a policy override.

Claiming Work

If the repo has a task file for the work type, write or update only the task state expected by that process. If no claim mechanism exists yet, keep the write set narrow and announce it in the handoff.

Good write scopes:

• one source folder plus its matching workflow/proposal folders,
• one episode read.json,
• one public lens concept doc,
• one validation/provenance patch across files that already reference each other.

Avoid broad edits across unrelated pages. Do not rewrite a whole atlas or concept family when the task asks for one delta.

Execution

Load the specific process skill for the job:

• raw-source video import: jiang-source-ingest
• transcript packet semantics: jiang-agent-transcript-pass
• boundary decisions: jiang-transcript-boundary-review
• public episode read: jiang-episode-read-writer
• episode publication: jiang-episode-publisher
• per-episode corpus impact when explicitly assigned to a corpus-impact worker: jiang-corpus-impact-pass
• concept page writing: jiang-lens-concept-writer
• atlas maintenance: jiang-lens-atlas-maintainer
• provenance linking: jiang-provenance-linker
• canon promotion: jiang-canon-promotion
• review: jiang-lens-judge

Use generated files as outputs, not as source-of-truth editing targets unless the relevant compiler script owns them.

Validation

For content or tooling changes, run:

node ops/scripts/compile-content.mjs
node ops/scripts/validate-content.mjs

For website-visible changes, also run:

cd website && npm run build

If validation fails, fix the failure inside your write scope when possible. If it fails because of unrelated concurrent work, report the exact failure and leave your files coherent.

Handoff

End with:

• what artifact you produced,
• which files you changed,
• what validation ran,
• any blocked or deferred work,
• the next useful autonomous job.

Do not claim canon status unless a canon promotion record exists.