LUKSO-LLM-Coding-Starterkit

Drop-in context that turns AI coding assistants (Claude Code, OpenAI Codex, and any tool that reads AGENTS.md) into a competent LUKSO engineer in any repo.

It ships stable, portable LUKSO knowledge (network parameters, LSP standards, developer tooling, core contract addresses, source priority, and claims to verify) as an overlay on the general multi-provider orchestration setup. Volatile facts (programs, grants, migration status, counts, prices) are intentionally left out and flagged as "verify live", so the kit does not go stale.

What's inside

File	Purpose
AGENTS.md	LUKSO-specific overlay loaded on top of the globally installed general baseline.
CLAUDE.md	Thin Claude Code entry point that imports the local LUKSO overlay.
LUKSO_CONTEXT.md	The extended LUKSO reference: concepts, full LSP cheat sheet, tooling, ecosystem projects, example phrasings, and source URLs. Read on demand.
scripts/install-global.sh	Installs the general orchestration dependency, then stores the LUKSO context alongside it.
LICENSE	MIT — use, modify, and redistribute freely.

How it works

• The general installer stores the provider-neutral rules in ~/.codex/AGENTS.md and the playbook in ~/.codex/ORCHESTRATION.md.
• Codex automatically combines that global baseline with this repo's local AGENTS.md LUKSO overlay.
• Claude Code loads the same global baseline through ~/.claude/CLAUDE.md, then imports the local overlay through this repo's CLAUDE.md.
• The LUKSO overlay points to LUKSO_CONTEXT.md for extended domain depth.

Multi-model, multi-tool orchestration

The general repository is the single source of truth for model routing, delegation, cross-provider review, and hand-off commands. Sol owns Codex-led work and Fable owns Claude-led work, but ownership does not lock out the other orchestrator: Sol can call fable-review for complex code or architecture review, while Fable can use Sol for the corresponding Codex-side judgement.

Read the full orchestration playbook for current routing and verification rules.

Install

Option A: per repo (committed, shareable with your team)

Copy the context files into the root of your project:

cp AGENTS.md CLAUDE.md LUKSO_CONTEXT.md /path/to/your/lukso-repo/

Install the general baseline once with ./scripts/install-global.sh, then replace the ## This repo section in the copied AGENTS.md with the project's stack, conventions, gotchas, and build/test commands.

Option B: global (every repo on your machine, not committed)

Install or refresh the general baseline and its LUKSO reference:

./scripts/install-global.sh

The installer uses a sibling multi-provider-orchestration checkout when available, honors MULTI_PROVIDER_ORCHESTRATION_DIR, or clones the general repo into ~/.local/share. It runs the general installer first, then installs LUKSO_CONTEXT.md under ~/.codex. Existing Claude instructions remain untouched, and differing context files are backed up before replacement.

A managed cached clone is fast-forwarded when clean. Local cache changes are never overwritten; an incomplete cache produces an explicit recovery message.

The general installer also provides claude-review, fable-review, and sol-review for symmetric read-only cross-provider review.

The LUKSO overlay itself remains repo-local so unrelated repositories receive the general orchestration rules without LUKSO-specific instructions.

Customizing

• Put shared stack, conventions, gotchas, and build/test commands under ## This repo in AGENTS.md. Put only Claude-specific overrides in CLAUDE.md.
• Keep the LUKSO facts current by trusting live sources over this kit. The source priority is listed at the top of AGENTS.md and LUKSO_CONTEXT.md.

Important

This kit is a baseline, not a source of truth. LUKSO facts can change. Always verify anything time-sensitive against live sources before publishing:

1. https://lukso.network
2. https://docs.lukso.tech
3. https://github.com/lukso-network

License

Released under the MIT License — you're free to use, modify, and redistribute it, including commercially. Attribution is appreciated but not required.