Jiang autonomous work protocol

Skill apresmoi/jianglens/.codex/skills/jiang-autonomous-work-protocol

Agentic Organization Research Project - Jiang Lens is an independent research and reading project built from Jiang Xueqin's lectures, interviews, and writing.

Install

npx -y skills add apresmoi/jianglens --skill jiang-autonomous-work-protocol

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

3.7 KB, as published. Nobody here has run it

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.