Agent Skill
2/7/2026

python-cheatsheet

Quick reference mapping global architecture concepts to Python/FastAPI/SQLAlchemy syntax. For concepts, see the global skills.

K
krazyuniks
0GitHub Stars
1Views
npx skills add krazyuniks/guitar-tone-shootout

SKILL.md

Namepython-cheatsheet
DescriptionQuick reference mapping global architecture concepts to Python/FastAPI/SQLAlchemy syntax. For concepts, see the global skills.

Guitar Tone Shootout

A/B testing platform for guitar tones.

Documentation

WhatWhere
Development setupDEVELOPMENT.md
Agent rulesAGENTS.md
Technical architecturewiki/GTS-Technical-Architecture.md
Reference architecturewiki/REFERENCE-ARCHITECTURE.md

Agent Configuration Architecture

Six layers, loaded in order:

LayerPathLoadedPurpose
Global preferences~/.claude/CLAUDE.mdAlwaysBritish English, conventional commits, foundational principles
Project rulesAGENTS.mdAlwaysAll GTS rules in one file
Bounded contextlibs/*/CLAUDE.md, apps/*/CLAUDE.mdWhen in subdirDependencies, key patterns, key files
Hooks.claude/hooks/On tool useDeterministic enforcement (mock-gate, protect-config, infra-block)
Skills.claude/skills/ (7 project, 5 global)On invocationGTS-specific domain knowledge only
Memory~/.claude/projects/.../memory/MEMORY.mdAlwaysSession-learned facts

Documentation Source of Truth

  • For humans: Wiki (GTS-Technical-Architecture.md, REFERENCE-ARCHITECTURE.md)
  • For agents: AGENTS.md + per-context CLAUDE.md + gts-architecture skill (13 reference files)
  • AGENTS.md links to wiki for deep dives. No duplication.

Wiki Indexing

  • .planning/wiki-indexes/ — auto-generated section indexes for agent consumption
  • just index-wiki — regenerates indexes
  • .planning/codebase/ — auto-generated structure, schema, endpoints, imports, tests

What We Decided NOT To Do

  • ChromaDB/RAG: ~1,200 lines of config fits passive context. Not needed yet.
  • Future path: FTS5 + MCP server (like Obsidian Knowledge Index) when scaling beyond context window.
  • Pipe-delimited compression (Vercel style): Structured markdown is more maintainable for this project size.
  • Per-file lint hook: Pre-commit (prek + ruff) handles linting at commit time. No Claude-visible lint rules.

Cross-Agent Sync

  • agent-sync copies .claude/skills/.agents/skills/ (Codex), ~/.gemini/skills/, ~/.codex/skills/
  • cod wrapper runs agent-sync --quiet before every invocation
  • .agents/skills/ and .gemini/skills/ are gitignored — derived, not source of truth
Skills Info
Original Name:python-cheatsheetAuthor:krazyuniks