mit einem Klick
regenerating-a-technical-summary-of-stellar-core
// Instructions for regenerating the full set of subsystem and whole-system technical summary skill documents for stellar-core
// Instructions for regenerating the full set of subsystem and whole-system technical summary skill documents for stellar-core
[HINT] Laden Sie das komplette Skill-Verzeichnis einschließlich SKILL.md und aller zugehörigen Dateien herunter
| name | regenerating a technical summary of stellar-core |
| description | 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:
---
name: "subsystem-summary-of-$X"
description: "read this skill for a token-efficient summary of the $X subsystem"
---
# Subsystem: $X
## Key Classes and Data Structures
...
## Key Modules
...
## Key Functions
...
## Control Loops, Threads, and Tasks
...
## Ownership Relationships
...
## Key Data Flows
...
The summary should be approximately 10KB and focus on:
src/rust/src/ and src/rust/*.h/*.cpp, but exclude src/rust/soroban/.p26), specifically soroban-env-common/src/ and soroban-env-host/src/. Cover Val types, Env traits, Host internals, budget/metering, storage model, and VM dispatch.*Tests.cpp).After all subsystem summaries are complete, launch a sub-agent that:
.claude/skills/stellar-core-summary/SKILL.mdThe description should indicate this is good initial context for any broad-scope task on stellar-core.
Regenerate summaries when:
p26 reference to the latest)p26) should be updated to the latest version when regenerating.name: and description: fields.