# Code Module Summaries

Use when scanning an arbitrary Git repository to create, refresh, or selectively update...

- Repository: https://github.com/DemonDamon/AgenticX (866 stars)
- Category: Git and review
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add DemonDamon/AgenticX --skill code-module-summaries -g -a claude-code -y`
Codex: `npx skills add DemonDamon/AgenticX --skill code-module-summaries -g -a codex -y`
Cursor: `npx skills add DemonDamon/AgenticX --skill code-module-summaries -g -a cursor -y`
Gemini CLI: `npx skills add DemonDamon/AgenticX --skill code-module-summaries -g -a gemini-cli -y`

## Description

Use when scanning an arbitrary Git repository to create, refresh, or selectively update Markdown summaries of code modules, especially when changes must be traced from each module's last successful update.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Code Module Summaries

## Overview

Build and maintain evidence-backed Markdown summaries for an arbitrary Git
repository. Treat each module's last successful commit SHA as its incremental
checkpoint. Timestamps and Markdown mtimes are display metadata only.

The tracked control directory is the source of truth:

- `registry.json`: stable module boundaries, layout, and summary paths.
- `state/<module-id>.json`: one independent checkpoint per module.
- `modules/*.md`: summaries when using the centralized layout.
- `INDEX.md`: links and module ownership; update only when mappings change.

## Invocation

Interpret user arguments with this contract:

```text
/code-module-summaries [repo]
  [--output <control-dir>]
  [--layout centralized|colocated|custom]
  [--update]
  [--module <id-or-exact-name>]...
  [--target <git-ref>]
  [--refresh-modules]
  [--summary-name <filename.md>]
  [--head-only]
  [--accept-summary-drift]
  [--adopt-existing-summary]
  [--rebaseline --reason <text>]
```

Defaults:

- `repo`: current Git root.
- `--output`: `code-summaries/`.
- `--layout`: `centralized`.
- `--target`: the registry's `tracked_ref`, normally `HEAD`.
- `--summary-name`: `MODULE_SUMMARY.md` for colocated summaries.

`--layout custom` places each module's Markdown at an arbitrary in-repository
`.md` path declared per module in `registry.json` (`summary_path`), with no
fixed directory shape. This is the layout for a shared `conclusions/`-style
tree, for example `enterprise/conclusions/apps/gateway_conclusion.md`. A custom
registry may also declare a top-level `index_path` (e.g.
`enterprise/conclusions/README.md`): a managed overview file the agent
maintains, excluded from module source diffs and unassigned-path checks. See
[REFERENCE.md](REFERENCE.md) §9 for exact rules. `centralized` and `colocated`
are unchanged.

`--module` is repeatable and case-sensitive. It selects exact IDs first, then
an exact unique name. Never use fuzzy matching for a write operation.

The rest: https://github.com/DemonDamon/AgenticX/blob/HEAD/.cursor/skills/code-module-summaries/SKILL.md