AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

knowledge-ops

Use when writing, checking or cleaning up SOPs and runbooks. Generates them with sop_generator.py, checks 5W2H completeness and links with runbook_validator.py and ingests an existing knowledge base with kb_ingester.py.

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--knowledge-ops at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 6

assets/sop_template.md

SOP Template — fill out before running sop_generator.py

Use this template to capture the SOP metadata before invoking the generator. Fill in the fields below, then translate them into the JSON skeleton at the bottom of this file. Feed that JSON into the generator:

python3 scripts/sop_generator.py --input my-sop.json --profile ops
python3 scripts/sop_generator.py --input my-sop.json --profile regulated  # for SOX / HIPAA / ISO 13485 / FDA

SOP metadata

  • SOP name: (e.g., Vendor Offboarding, Procurement Intake, Employee Onboarding, Customer Escalation, System Access Provisioning)
  • Process owner (named human): (e.g., [email protected] — not "the team")
  • Triggering event: (what specifically starts the process — e.g., "Vendor contract not renewed OR vendor terminated for cause")
  • Audience role: (who will execute this SOP — e.g., "Vendor Management Office operator", "HR onboarding specialist")
  • Frequency: (how often this runs — "Daily", "Weekly Monday 9am", "On-demand avg 3x/quarter")
  • Regulatory overlay: (zero or more of: SOC2, HIPAA, ISO13485, GDPR, SOX. If "none", confirm by listing data classes the process touches.)

Inputs and outputs

Inputs required before starting:

  • (input 1 — e.g., "Vendor legal name")
  • (input 2 — e.g., "Contract end date")
  • (input 3 — e.g., "List of systems with vendor access")

Outputs produced:

  • (output 1 — e.g., "All production system access revoked, evidenced in IAM audit log")
  • (output 2 — e.g., "Vendor data deletion certified")
  • (output 3 — e.g., "Final invoice reconciled and paid")

Steps outline

Six rows to start; add or remove. Each step must be a noun-phrase action, not a paragraph.

| # | Step name (action) | Notes | |---|--------------------|-------| | 1 | e.g., Notify vendor of offboarding intent (30 days written notice) | | | 2 | e.g., Inventory data classes and system access vendor holds | | | 3 | e.g., Revoke production system access (IAM, VPN, SaaS) | | | 4 | e.g., Confirm data deletion (vendor certification) or data return | | | 5 | e.g., Final invoice reconciliation and payment | | | 6 | e.g., Archive vendor record in VMO registry with offboarding evidence | |


How-much (cost model)

  • Estimated execution time: (minutes per execution — e.g., 240)
  • Estimated cost per execution: (USD, labor + license + third-party fees — e.g., 800)

JSON skeleton

{
  "sop_name": "Vendor Offboarding",
  "process_owner": "[email protected] (Vendor Management Lead)",
  "triggering_event": "Vendor contract not renewed OR vendor terminated for cause",
  "audience_role": "Vendor Management Office (VMO) operator",
  "frequency": "On-demand (avg 3 executions per quarter)",
  "regulatory_overlay": ["SOC2"],
  "inputs": [
    "Vendor legal name",
    "Contract end date",
    "List of systems with vendor access",
    "List of data classes vendor processed"
  ],
  "outputs": [
    "All production system access revoked (evidenced)",
    "Vendor data deleted or returned (evidenced)",
    "Final invoice reconciled and paid",
    "Vendor record archived in VMO registry with offboarding evidence"
  ],
  "steps_outline": [
    "Notify vendor of offboarding intent (written, 30 days notice)",
    "Inventory data classes and system access vendor holds",
    "Revoke production system access (IAM, VPN, SaaS)",
    "Confirm data deletion (vendor certification) or data return",
    "Final invoice reconciliation and payment",
    "Archive vendor record in VMO registry with offboarding evidence"
  ],
  "estimated_minutes": 240,
  "estimated_cost_usd": 800
}

Authoring discipline checklist

Before submitting the JSON to the generator, confirm:

  • [ ] Owner is a named human, not "the team" — required by Gawande Checklist Manifesto discipline.
  • [ ] Triggering event is specific. "When needed" is not a trigger.
  • [ ] At least one regulatory overlay considered (or explicit "none after checking PHI/financial/regulated-device classes").
  • [ ] Top-2 failure modes documented — happy-path-only SOPs are responsible for 60%+ of incident-time waste (Fowler 2016).
  • [ ] "How-much" is filled in. It's the section authors most often forget — and the section operators most need.
  • [ ] --profile regulated selected if SOP touches SOX, HIPAA, ISO 13485, FDA 21 CFR Part 211, or SOC 2 controls.

After generation, run the runbook validator on any embedded step lists that include state-mutating operations:

python3 scripts/runbook_validator.py --input generated-sop.md