mcpField
M
maintain

maintain

github.com/gwpicardOther239 installsUpdated today
Repository

About maintain

A maintenance skill for projects built with setup-ai-build-kit. It checks project records, live-copy differences, branch protection, secrets, release updates, and due routines while keeping uncommitted work out of commits.

Key features

  1. 01Check records and live-copy differences
  2. 02Check branch protection and secrets
  3. 03Track monthly and quarterly maintenance
  4. 04Route upgrade checks and kit updates

Use cases

  1. 01Review a project during a maintenance visit
  2. 02Identify due monthly or quarterly work
  3. 03Check for secrets and branch protection gaps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gwpicard/ai-build-kit --skill maintain

After installing, type/maintainin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

VERSION
references/
handover-retirement.md
kit-update.md
latest-release.md
monthly.md
project-checks.md
quarterly.md
recipe-move.md
risk-move.md
truing.md
scripts/
kit-leftovers.py
kit-released-copies.json
kit-retired-skills.json
old-skill-pointers.py
recipe-freshness.py
risk_move.py
settings-rules.py
standing-lines.sh
upgrade-check.py
templates/
handover.md

Details

From the project README

Maintain

Maintenance never offers queued, parallel, looped building or automatic merging.

Make the records true, compare the live copy with main, and finish a kit update. Report findings before applying anything beyond routine updates.

In Codex, if a push, fetch or remote check fails with unable to get password from user, run the installed setup-ai-build-kit skill's templates/foundation/codex-github-check.py with python3 and --message. Give its sentence and stop.

Every visit

  1. Load references/truing.md and follow it. Keep the person's uncommitted work out of every commit. Report it and point to /what-now; clean-checkpoint steps wait, while read-only steps continue. Read the project's recipe with scripts/recipe-freshness.py. If it reports a stale or superseded recipe, say its one-line finding and offer to open a piece to move to a current recommendation. On a no, change no project files.
  2. Compare the live copy with main using the live-copy skill. Do not change the live service or changelog. Offer /setup-hosting for backups, restores, previews or recipe checks, and name any gap.
  3. From the project root run merge/scripts/protect-branch.py --check <origin's owner/repository> main. Exit 0 means required; 3 records the private Free limit, with one notice and no offer; 4 means available, so offer to run without --check with approval. Report other exits. Do not change protection without that approval.
  4. Run the installed setup-ai-build-kit skill's templates/foundation/scan-secrets.sh from the project root with --all. Exit 0 means no secret was found, 1 means one was found, and 2 means the scan could not run. On a find, say to rotate it. Never show its value.
  5. Read .ai-build-kit-maintenance. Monthly work is due 30 days after last-light-pass, or founding if absent. Quarterly work is due 90 days after last-full-pass, at founding if absent, and when a handover is asked for. Either runs when requested. Say when skipped work falls due.
  6. Run scripts/upgrade-check.py --latest --route using references/latest-release.md.
  7. Finish a kit update using references/kit-update.md on every visit. The monthly routine's first step does it instead. In Codex, offer its session-start GitHub check.

Due routines

When monthly work is due, load references/monthly.md and follow it in order. For quarterly work, also load references/quarterly.md.

Handover and retirement

For handover or retirement, load references/handover-retirement.md.

Done when

Records match events; the protection check and live-copy gap are reported; due work and approved changes are saved; and the person knows when the next visit is due.

Comments

Markdown supported