maintain

A maintenance workflow for software that is already running in production. It covers monitoring, dependency updates, incident fixes, technical debt, regular reviews, and retirement.

In plain words
What is it for?
Use it after launch to review alerts, fix production bugs with regression tests, update dependencies in small batches, track deferred work, and decide when a product or environment should be retired.
Why use it?
It gives ongoing upkeep a clear order and prevents maintenance from turning into an unplanned rebuild. It also helps surface failures that would otherwise stay hidden.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/tradebaas/groundwork/maintain
Any agent
npx skills add Tradebaas/Groundwork --skill maintain
Clone the repo
git clone --depth 1 https://github.com/Tradebaas/Groundwork

Made for: Claude Code, Codex.

Per session 74 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,427 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00074 $0.01427
Opus 5 $0.00037 $0.00714
Sonnet 5 $0.00015 $0.00285
Haiku 4.5 $0.00007 $0.00143

Measured 2d ago against content hash 53c839660a94, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

maintain scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/maintain/SKILL.md · 94 lines

How it starts

The opening of the file, as written. The whole thing — 94 lines — stays where its author put it; the contents beside it link to each section on GitHub.

maintain: the product is now a running system

Maintenance sessions still follow the session protocol: STATE.md first, one task, state updated. Maintenance is scope-bound too; "while maintaining" is not a license to rebuild.

Observability: you cannot maintain what you cannot see

First maintenance session: confirm the minimum exists, or create it and record it in docs/operations/monitoring.md:

  • Errors are captured somewhere a human looks (error tracking, log alerts, per stack).
  • The critical flow has a heartbeat: you find out it broke before the user tells you.
  • Failure of background jobs/integrations is visible, not silently swallowed. The studied production system's worst bugs were invisible failures marked "done".

The maintenance loop (each session, in this order)

  1. Signals: errors, alerts, intake since last session. Triage bugs (fix + regression test) from wishes (INTAKE.md → scope).
  2. Dependencies: audit for known vulnerabilities (blocking; fix now), then routine updates in small, verified batches: never a big-bang upgrade with feature work mixed in. On a platform stack (the stack file's header declares a hosted platform) the audit has the same job and different subjects: connectors and the permissions they carry, installed managed solutions and store apps, plugins and custom code registered in the instance, and the vendor's own release and deprecation notices. Those last ones move on the vendor's schedule rather than yours, which is what makes a platform go stale while every project file sits untouched. The installed design method is a dependency too, and the only one that is not in a manifest: re-run node checks/design-method.mjs --install to take its current release (it reports the installed version and changes nothing when that is already the newest), read the version back from the enforcement line at the top of node checks/check.mjs, and note it in STATE.md when it moved. Read the release notes for a rule that was dropped: decision 0020 credits rules to that method, and one that disappears upstream comes back into a Groundwork file rather than being forked there.
  3. Debt harvest: grep -rn "defer:" --exclude-dir=.git . → reconcile with DEBT.md. Flag markers whose upgrade trigger has fired, and no-trigger markers (those rot silently). Paying debt is a proposed, owner-approved task like any other.
  4. Drift check: node checks/check.mjs + spot-check that STATE.md, BRIEF and reality still agree. Docs describing a system that no longer exists → fix + denylist.
  5. Success metrics: a read date in BRIEF's measurement plan that has passed gets read now, and the number written next to its criterion in BRIEF, dated. Nothing due, nothing to do. Measured below target is a finding for scope, not a defect for debug: the capability works, the value did not arrive.

Read the full file on GitHub · 94 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 94 lines · 0 tokens per session scan A 53c839660a94

Subscribe to this mod's changes

maintain is a skill published in the GitHub repository Tradebaas/Groundwork (2 stars, last pushed 7d ago), licensed MIT. It adds 74 tokens to every session and 1,427 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

mission-driver

Create roadmaps and mission configs, then drive the mission-driver AI dev-loop engine. mission-driver lives at tools/mission-driver/ — it reads missions/ .json and loops CHECK → REVIEWPLANS → EXECPLANS → DRAFTPLANS → DEEPAUDIT until the roadmap is done or the audit budget is exhausted. Use this skill when the user…

entropy-cloud/attractor-guided-engineering-template · 199 tokens

keel-plan

Create or revise PLAN.md — propose the phase DAG (phases · gates · dependencies) from the user's goal, get approval, write the table and regenerate the colored Mermaid diagram from it. Statuses flip at rituals (/keel-handover, /keel-phase-review); post-completion fixes land in the Fix log.

muratsilahtaroglu/claude-code-starter-kit · 70 tokens

keel-stats

Render the ritual telemetry visually — turns .claude/ritual-log into reports/ritual-stats.md with PLAN.md-style colored Mermaid interval boxes (session/compact boundaries) + a counts table. Answers "which skills/commands/hooks ran, how often, in which interval".

muratsilahtaroglu/claude-code-starter-kit · 62 tokens

sdd-serve

Serve the SDD Builder's AI request queue: claim requests with sddnextrequest, draft the proposal, answer with sddrespondrequest. Never writes spec files — the user accepts each proposal in the builder. Use when the user asks to attend, serve or listen to the SDD board queue. / Atiende la cola de peticiones del SDD…

juanklagos/spec-driven-development-template · 80 tokens

init

Configure an uninitialized project from an approved charter: stack, scripts, identity, optional Git, and verification.

bnet47/codexicon · 24 tokens

sdd-workflow

Guide a project with Spec-Driven Development (SDD) discipline - idea, approved spec, consistent plan, tasks, a gate that verifies approval and consent, implementation, validation, and logbook. Bilingual EN/ES. Use when the user wants to start, spec, plan, implement, or validate work with SDD, or mentions specs, plans…

juanklagos/spec-driven-development-template · 84 tokens