Update
Structured non-code project and knowledge management for Claude Code. (Before Karpathy made this fashionable...)
npx -y skills add OdinMB/ops-workflow --skill updateAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 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
Integrate external info (research, status changes, reference material, deliverables) into the ops repo's knowledge base. Drop files in .update/ or pass content inline.
SKILL.md
4.7 KB, as published. Nobody here has run it
Update
Ingest external information into this ops repo's knowledge base. Two modes depending on whether arguments are provided.
Detect Mode
- If
$ARGUMENTSis non-empty → Inline mode: the arguments contain the information to integrate. - If
$ARGUMENTSis empty or blank → Inbox mode: process files from.update/.
Inline Mode
The user provided content directly: $ARGUMENTS
-
Load context. Read
CLAUDE.mdandMEMORY.mdto understand the repo structure, goals, and current state. -
Classify the information. Apply the whole-file test from CLAUDE.md — fact about the world, or decision/framework?
- Fact about the world (status, metric, inventory) →
state/ - Decision / strategy / framework / guardrails / research →
references/ - Specific actions to do next →
backlog/ - Delivered output →
artifacts/ - Strategic insight → may also warrant a MEMORY.md Key Learnings update
- Mixed → split
Trap: "current strategic posture" content feels state-shaped but is forward-looking strategy →
references/. - Fact about the world (status, metric, inventory) →
-
Integrate. For each piece of information:
- Read the target file first — never overwrite blindly. Merge or append.
- When updating state files, update the
_Last updated: YYYY-MM-DD_line. - When adding backlog items, insert in priority order (highest first), not at the end.
- If placement is genuinely ambiguous, ask the user before proceeding.
-
INDEX.md cascade. For every file created or significantly changed, update that folder's
INDEX.md. If the folder's overall summary changed, cascade to the parentINDEX.md. -
MEMORY.md check. If the information shifts the project's strategic understanding — a new constraint, a key learning, a changed goal — add or update an entry under Key Learnings. Don't add specific data points (those belong in state/references); only add general insights.
-
Summarize. Tell the user what was placed where.
Inbox Mode
Process all files in the .update/ directory.
-
Load context. Read
CLAUDE.mdandMEMORY.md. -
List files. Check
.update/for files (skip.gitkeep). If empty, tell the user "No files in.update/to process" and stop. -
Process each file. For each file in
.update/:a. Read and understand the file's contents. Consider the filename, format, and content to determine what it is.
b. Classify — same categories as inline mode (status update, research, task, deliverable, mixed).
c. Extract and integrate relevant information into the knowledge base:
- Create or update files in
state/,references/,backlog/, orartifacts/as appropriate. - Read target files before writing — merge, don't overwrite.
- Update
_Last updated:_dates on state files. - Insert backlog items in priority order.
d. INDEX.md cascade — update every affected INDEX.md.
e. Dispose of the source file:
- Delete if all useful information has been extracted into structured knowledge (the common case — raw notes, status emails, data dumps).
- Move to
references/if the file itself is a useful reference to keep (e.g., a PDF report, a detailed analysis document). - Move to
artifacts/if the file is a deliverable or work product (e.g., a submitted application, a finalized spec). Date-prefix it if it's been delivered. - If unsure whether to keep or delete, ask the user.
- Create or update files in
-
MEMORY.md check — same as inline mode. Update Key Learnings if warranted.
-
Summarize. List each file processed, where its information was placed, and whether the file was deleted or moved.
Rules
- State vs. backlog separation — facts about current reality go in
state/. Actions and opportunities go inbacklog/. Don't mix them. - Don't duplicate — before creating a new file, check if an existing file already covers that topic. Extend the existing file rather than creating a parallel one.
- Preserve structure — follow the repo's existing organizational patterns. If grants info lives in
references/grants/, new grant research goes there too. - Cite sources — if the incoming information references external sources (URLs, documents, people), preserve those citations in the integrated output.
- Be conservative with MEMORY.md — most updates don't warrant a Key Learnings entry. Only add entries that change the project's strategic understanding.