claude-md-help · diff

git:20260708.e42b71f to git:20260920.c148195

1 added, 1 removed. Audit A to A.

---

name: "claude-md-help"

description: "Overview of CLAUDE.md management commands"

---

## Codex harness adaptations

Generated from a Claude Code command. Where the procedure references these Claude-only surfaces, adapt as follows:

- - `CLAUDE.md` references: Codex reads `AGENTS.md`; treat them as the target repo's agent-context file.

+ - `CLAUDE.md` references: read `AGENTS.md` first - it is the Codex entry point. Where it defers to `CLAUDE.md`, follow that pointer and `CLAUDE.md` is the rules; where it does not, `AGENTS.md` is. Where the repository has no `AGENTS.md`, read `CLAUDE.md`.

# CLAUDE.md Commands

Audit and manage your project's CLAUDE.md governance directives.

## Commands

| Command | Description |

|---------|-------------|

| `/claude-md-lint` | Audit CLAUDE.md for CI/CD, Docker, and troubleshooting directives |

| `/claude-md-help` | This help page |

## Why CLAUDE.md Governance Matters

CLAUDE.md is the primary mechanism for directing Claude Code agent behavior. Without explicit CI/CD and troubleshooting directives, agents default to ad-hoc approaches that bypass your project's build pipeline.

`/claude-md-lint` checks that your CLAUDE.md includes:

| Category | What It Checks |

|----------|----------------|

| CI/CD Protocol | Makefile targets referenced for build/test/deploy |

| Troubleshooting Protocol | Directives to fix CI/CD alongside code |

| Quality Gates | `make lint`, `make test`, `make verify` mentioned |

| Docker Conventions | `make docker-*` targets (if Docker files exist) |

| Deployment Protocol | `make deploy` or deployment workflow |

| Available Commands | Makefile targets listed for reference |

## Scoring

| Score | Rating |

|-------|--------|

| 5-6 / 6 | HEALTHY |

| 3-4 / 6 | NEEDS ATTENTION |

| 0-2 / 6 | UNHEALTHY |

## Quick Start

```bash

# Audit your CLAUDE.md

/claude-md-lint

# Fix gaps in your Makefile first

/cicd-check

# Full project health: Makefile + CLAUDE.md

/cicd-check && /claude-md-lint

```

## Related

- `/cicd-check` - Validate Makefile targets

- `/cicd-init` - Generate Makefile from detected framework

- `/project-init` - Full project scaffolding (generates CLAUDE.md with directives)