agentleFS
tuana-vntuana-vn/system-reverse-engineer/.github/skills/configuration-source-trace/SKILL.md

configuration-source-trace

Skill0 starsChanged 2 months agoMITView on GitHub

Trace behavior-changing configuration from its external/source definition through loader, key/default/override precedence, runtime state, consumer branch, and resulting behavior; use to close configuration-origin unknowns.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Search from BOTH ends:

    line 37
  2. Distinctive:

    If the actual deployed VALUE is unavailable but source proves the injection mechanism, separate:

    line 88
  3. Distinctive:

    Do not mark the entire configuration architecture UNKNOWN.

    line 95
  4. Distinctive:

    Update open questions/evidence ledger as appropriate.

    line 117
  5. Distinctive:

    Prefer the settings that change architecture, routing, concurrency, integration selection, lifecycle, persistence, security, or externally …

    line 133

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Configuration Source Trace

Mission

Answer precisely:

Where does this configuration value come from?
How is it overridden?
How does it reach runtime behavior?

Required Trace

For each material setting:

source
→ file/env/system property/DB/CLI/default
→ key/schema
→ loader/parser
→ validation/conversion
→ precedence/override
→ runtime object/state
→ consumer
→ branch/selection
→ behavioral effect

Search Strategy

Search from BOTH ends:

Consumer backward

branch/getter/field
→ assignment
→ constructor/setter/config object
→ loader
→ external source/key

Source forward

key/property/env/schema
→ parser
→ config object
→ consumer
→ runtime behavior

Inspect:

  • property/yaml/json/xml files
  • environment variables
  • system properties
  • command-line args
  • DB-backed settings
  • config defaults/constants
  • profiles/overlays
  • startup/bootstrap
  • tests showing override precedence

Required Findings

SettingExternal SourceKeyDefaultOverride PrecedenceLoaderRuntime HolderConsumerBehavioral EffectEvidenceStatus

Status:

VERIFIED
PARTIALLY_VERIFIED
EXTERNALLY_INJECTED
NOT_APPLICABLE
UNRESOLVED

External Values

If the actual deployed VALUE is unavailable but source proves the injection mechanism, separate:

configuration mechanism = VERIFIED
runtime deployed value = EXTERNALLY_BLOCKED

Do not mark the entire configuration architecture UNKNOWN.

Counterexample Search

Search for:

  • duplicate keys
  • deprecated keys
  • alternate loaders
  • profile-specific overrides
  • defaults that bypass external configuration
  • DB/runtime overrides
  • test-only configuration

Output

Create/update:

docs/reverse-engineering/configuration/<scope>.md

Update open questions/evidence ledger as appropriate.

Canonical Configuration Model

For full-baseline execution, consolidate behavior-changing settings into:

docs/reverse-engineering/models/configuration_model.md

Required fields:

Setting/SelectorSourceDefaultOverride PrecedenceRuntime HolderConsumerBehavioral EffectVariant SelectedEvidence

Prefer the settings that change architecture, routing, concurrency, integration selection, lifecycle, persistence, security, or externally observable behavior. Do not bury these selectors in an exhaustive property dump.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.