Instructions for regenerating the full set of subsystem and whole-system technical summary skill documents for stellar-core
This skill describes the process of generating (or regenerating) the full set of technical summary skill documents for stellar-core. These summaries provide AI agents with compact architectural context about each subsystem and the system as a whole.
The process produces:
.claude/skills/subsystem-summary-of-$X/SKILL.md.claude/skills/stellar-core-summary/SKILL.mdThe following subsystem directories under src/ are each summarized individually:
| Subsystem | Source Directory | Notes |
|---|---|---|
| bucket |
src/bucket/| Bucket list and merge machinery |
| catchup | src/catchup/ | Ledger catchup / sync logic |
| crypto | src/crypto/ | Hashing, signing, key management |
| database | src/database/ | SQL database abstraction |
| herder | src/herder/ | Consensus coordination, tx queue |
| history | src/history/ | History archive management |
| historywork | src/historywork/ | Work tasks for history operations |
| invariant | src/invariant/ | Runtime invariant checking |
| ledger | src/ledger/ | Ledger state management, LedgerTxn |
| main | src/main/ | Application, Config, event loop |
| overlay | src/overlay/ | P2P network layer |
| process | src/process/ | Child process management |
| protocol-curr | src/protocol-curr/ | Current protocol XDR definitions |
| rust | src/rust/ (excl. soroban/) | C++/Rust bridge, non-soroban Rust |
| soroban-env | src/rust/soroban/p26/soroban-env-{common,host}/ | One protocol version of soroban env |
| scp | src/scp/ | SCP consensus protocol |
| simulation | src/simulation/ | Network simulation, load generation |
| test | src/test/ | Test utilities and infrastructure |
| transactions | src/transactions/ | Transaction/operation processing |
| util | src/util/ | Utility classes and helpers |
| work | src/work/ | Async work scheduling framework |
For each subsystem directory listed above, launch a parallel sub-agent with the following instructions:
Read the entire source of all .h, .cpp, and/or .rs files in that subsystem directory, excluding any test files (files with "test" or "Test" in the name, or files ending in Tests.cpp, Test.cpp, test.cpp).
Create a skill document at .claude/skills/subsystem-summary-of-$X/SKILL.md
Write the document using this template:
---