Skip to content
cccskills
FreePublished on GitHub

maintain

Detect and fix stale claude/*.md knowledge docs. Use when claude/architecture.md or build.md references missing files, wrong commands, or outdated patterns. Keeps the knowledge base accurate.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Maintain Skill

Keep the brain knowledge base accurate and current.

When to use

  • After a major refactor that changed file structure
  • When a command in claude/build.md produces "command not found"
  • When claude/architecture.md references a directory that no longer exists
  • Periodically as part of session end

Protocol

1. Scan claude/*.md files for staleness signals

Read each claude/*.md file and flag:

  • Directory paths that no longer exist
  • Commands that fail when run
  • Service names that no longer exist in the codebase
  • {{PLACEHOLDER}} tokens that were never filled in
  • References to files that have been deleted or moved

2. Verify each flagged item

# Check if a directory exists
ls claude/path/to/check 2>&1

# Check if a command is available
which command_name 2>&1

3. Fix verified stale content

  • Update paths to reflect current structure
  • Update commands based on current package.json/Makefile
  • Remove references to deleted services/modules
  • Fill in any remaining {{PLACEHOLDER}} tokens

4. Add new knowledge (opportunistic)

If you discover new facts about the codebase during maintenance, add them to the appropriate claude/*.md file.

5. Report changes

List every file updated with a one-line description of what changed.

Rules

  • NEVER remove knowledge without verifying it's actually stale
  • NEVER add speculative content — only add what you've verified
  • Document the maintenance run in claude/tasks/lessons.md
  • Stale docs are bugs — treat them with the same urgency as code bugs

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ask

Free

Route a codebase question to the right tool — structural graph, semantic search, or risk analysis. Use when you need to find or understand code without knowing exact file names.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Auto-configure CLAUDE.md and claude/ knowledge docs for a new project. Use when setting up Brain Bootstrap in a new repository. Discovers the codebase, fills in templates, and writes project-specific configuration.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Use before any new feature, component, or behavioral change — when you need to explore requirements and design before writing code

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Activate safety guards for the session. Use /careful before critical operations — blocks rm -rf, DROP TABLE, git push --force, kubectl delete namespace, docker system prune via PreToolUse hook.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Generate a user-facing changelog from git commits — categorize, filter noise, translate to user language. Runs in isolated fork context.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Save session state before context gets full or before ending. Writes current task state, branch, and loaded docs to claude/tasks/todo.md so the next session can resume cleanly.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

See all skills by brain-bootstrap

Report a problem with this skill