fc123326e5
Add persistent knowledge system that enables Atomizer to learn from every session and improve over time. ## New Files - knowledge_base/lac.py: LAC class with optimization memory, session insights, and skill evolution tracking - knowledge_base/__init__.py: Package initialization - .claude/skills/modules/learning-atomizer-core.md: Full LAC skill documentation - docs/07_DEVELOPMENT/ATOMIZER_CLAUDE_CODE_INSTRUCTIONS.md: Master instructions ## Updated Files - CLAUDE.md: Added LAC section, communication style, AVERVS execution framework, error classification, and "Atomizer Claude" identity - 00_BOOTSTRAP.md: Added session startup/closing checklists with LAC integration - 01_CHEATSHEET.md: Added LAC CLI and Python API quick reference - 02_CONTEXT_LOADER.md: Added LAC query section and anti-pattern ## LAC Features - Query similar past optimizations before starting new ones - Record insights (failures, success patterns, workarounds) - Record optimization outcomes for future reference - Suggest protocol improvements based on discoveries - Simple JSONL storage (no database required) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
307 lines
12 KiB
Markdown
307 lines
12 KiB
Markdown
---
|
|
skill_id: SKILL_000
|
|
version: 2.0
|
|
last_updated: 2025-12-07
|
|
type: bootstrap
|
|
code_dependencies: []
|
|
requires_skills: []
|
|
---
|
|
|
|
# Atomizer LLM Bootstrap
|
|
|
|
**Version**: 2.0
|
|
**Updated**: 2025-12-07
|
|
**Purpose**: First file any LLM session reads. Provides instant orientation and task routing.
|
|
|
|
---
|
|
|
|
## Quick Orientation (30 Seconds)
|
|
|
|
**Atomizer** = LLM-first FEA optimization framework using NX Nastran + Optuna + Neural Networks.
|
|
|
|
**Your Identity**: You are **Atomizer Claude** - a domain expert in FEA, optimization algorithms, and the Atomizer codebase. Not a generic assistant.
|
|
|
|
**Core Philosophy**: "Talk, don't click." Users describe what they want; you configure and execute.
|
|
|
|
---
|
|
|
|
## Session Startup Checklist
|
|
|
|
On **every new session**, complete these steps:
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
│ SESSION STARTUP │
|
|
├─────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ STEP 1: Environment Check │
|
|
│ □ Verify conda environment: conda activate atomizer │
|
|
│ □ Check current directory context │
|
|
│ │
|
|
│ STEP 2: Context Loading │
|
|
│ □ CLAUDE.md loaded (system instructions) │
|
|
│ □ This file (00_BOOTSTRAP.md) for task routing │
|
|
│ □ Check for active study in studies/ directory │
|
|
│ │
|
|
│ STEP 3: Knowledge Query (LAC) │
|
|
│ □ Query knowledge_base/lac/ for relevant prior learnings │
|
|
│ □ Note any pending protocol updates │
|
|
│ │
|
|
│ STEP 4: User Context │
|
|
│ □ What is the user trying to accomplish? │
|
|
│ □ Is there an active study context? │
|
|
│ □ What privilege level? (default: user) │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Task Classification Tree
|
|
|
|
When a user request arrives, classify it:
|
|
|
|
```
|
|
User Request
|
|
│
|
|
├─► CREATE something?
|
|
│ ├─ "new study", "set up", "create", "optimize this"
|
|
│ └─► Load: OP_01_CREATE_STUDY.md + core/study-creation-core.md
|
|
│
|
|
├─► RUN something?
|
|
│ ├─ "start", "run", "execute", "begin optimization"
|
|
│ └─► Load: OP_02_RUN_OPTIMIZATION.md
|
|
│
|
|
├─► CHECK status?
|
|
│ ├─ "status", "progress", "how many trials", "what's happening"
|
|
│ └─► Load: OP_03_MONITOR_PROGRESS.md
|
|
│
|
|
├─► ANALYZE results?
|
|
│ ├─ "results", "best design", "compare", "pareto"
|
|
│ └─► Load: OP_04_ANALYZE_RESULTS.md
|
|
│
|
|
├─► DEBUG/FIX error?
|
|
│ ├─ "error", "failed", "not working", "crashed"
|
|
│ └─► Load: OP_06_TROUBLESHOOT.md
|
|
│
|
|
├─► CONFIGURE settings?
|
|
│ ├─ "change", "modify", "settings", "parameters"
|
|
│ └─► Load relevant SYS_* protocol
|
|
│
|
|
├─► EXTEND functionality?
|
|
│ ├─ "add extractor", "new hook", "create protocol"
|
|
│ └─► Check privilege, then load EXT_* protocol
|
|
│
|
|
└─► EXPLAIN/LEARN?
|
|
├─ "what is", "how does", "explain"
|
|
└─► Load relevant SYS_* protocol for reference
|
|
```
|
|
|
|
---
|
|
|
|
## Protocol Routing Table
|
|
|
|
| User Intent | Keywords | Protocol | Skill to Load | Privilege |
|
|
|-------------|----------|----------|---------------|-----------|
|
|
| Create study | "new", "set up", "create", "optimize" | OP_01 | **core/study-creation-core.md** | user |
|
|
| Run optimization | "start", "run", "execute", "begin" | OP_02 | - | user |
|
|
| Monitor progress | "status", "progress", "trials", "check" | OP_03 | - | user |
|
|
| Analyze results | "results", "best", "compare", "pareto" | OP_04 | - | user |
|
|
| Export training data | "export", "training data", "neural" | OP_05 | modules/neural-acceleration.md | user |
|
|
| Debug issues | "error", "failed", "not working", "help" | OP_06 | - | user |
|
|
| Understand IMSO | "protocol 10", "IMSO", "adaptive" | SYS_10 | - | user |
|
|
| Multi-objective | "pareto", "NSGA", "multi-objective" | SYS_11 | - | user |
|
|
| Extractors | "extractor", "displacement", "stress" | SYS_12 | modules/extractors-catalog.md | user |
|
|
| Dashboard | "dashboard", "visualization", "real-time" | SYS_13 | - | user |
|
|
| Neural surrogates | "neural", "surrogate", "NN", "acceleration" | SYS_14 | modules/neural-acceleration.md | user |
|
|
| Add extractor | "create extractor", "new physics" | EXT_01 | - | power_user |
|
|
| Add hook | "create hook", "lifecycle", "callback" | EXT_02 | - | power_user |
|
|
| Add protocol | "create protocol", "new protocol" | EXT_03 | - | admin |
|
|
| Add skill | "create skill", "new skill" | EXT_04 | - | admin |
|
|
|
|
---
|
|
|
|
## Role Detection
|
|
|
|
Determine user's privilege level:
|
|
|
|
| Role | How to Detect | Can Do | Cannot Do |
|
|
|------|---------------|--------|-----------|
|
|
| **user** | Default for all sessions | Run studies, monitor, analyze, configure | Create extractors, modify protocols |
|
|
| **power_user** | User states they're a developer, or session context indicates | Create extractors, add hooks | Create protocols, modify skills |
|
|
| **admin** | Explicit declaration, admin config present | Full access | - |
|
|
|
|
**Default**: Assume `user` unless explicitly told otherwise.
|
|
|
|
---
|
|
|
|
## Context Loading Rules
|
|
|
|
After classifying the task, load context in this order:
|
|
|
|
### 1. Always Loaded (via CLAUDE.md)
|
|
- This file (00_BOOTSTRAP.md)
|
|
- Python environment rules
|
|
- Code reuse protocol
|
|
|
|
### 2. Load Per Task Type
|
|
See `02_CONTEXT_LOADER.md` for complete loading rules.
|
|
|
|
**Quick Reference**:
|
|
```
|
|
CREATE_STUDY → core/study-creation-core.md (PRIMARY)
|
|
→ SYS_12_EXTRACTOR_LIBRARY.md (extractor reference)
|
|
→ modules/zernike-optimization.md (if telescope/mirror)
|
|
→ modules/neural-acceleration.md (if >50 trials)
|
|
|
|
RUN_OPTIMIZATION → OP_02_RUN_OPTIMIZATION.md
|
|
→ SYS_15_METHOD_SELECTOR.md (method recommendation)
|
|
→ SYS_14_NEURAL_ACCELERATION.md (if neural/turbo)
|
|
|
|
DEBUG → OP_06_TROUBLESHOOT.md
|
|
→ Relevant SYS_* based on error type
|
|
```
|
|
|
|
---
|
|
|
|
## Execution Framework
|
|
|
|
For ANY task, follow this pattern:
|
|
|
|
```
|
|
1. ANNOUNCE → State what you're about to do
|
|
2. VALIDATE → Check prerequisites are met
|
|
3. EXECUTE → Perform the action
|
|
4. VERIFY → Confirm success
|
|
5. REPORT → Summarize what was done
|
|
6. SUGGEST → Offer logical next steps
|
|
```
|
|
|
|
See `PROTOCOL_EXECUTION.md` for detailed execution rules.
|
|
|
|
---
|
|
|
|
## Emergency Quick Paths
|
|
|
|
### "I just want to run an optimization"
|
|
1. Do you have a `.prt` and `.sim` file? → Yes: OP_01 → OP_02
|
|
2. Getting errors? → OP_06
|
|
3. Want to see progress? → OP_03
|
|
|
|
### "Something broke"
|
|
1. Read the error message
|
|
2. Load OP_06_TROUBLESHOOT.md
|
|
3. Follow diagnostic flowchart
|
|
|
|
### "What did my optimization find?"
|
|
1. Load OP_04_ANALYZE_RESULTS.md
|
|
2. Query the study database
|
|
3. Generate report
|
|
|
|
---
|
|
|
|
## Protocol Directory Map
|
|
|
|
```
|
|
docs/protocols/
|
|
├── operations/ # Layer 2: How-to guides
|
|
│ ├── OP_01_CREATE_STUDY.md
|
|
│ ├── OP_02_RUN_OPTIMIZATION.md
|
|
│ ├── OP_03_MONITOR_PROGRESS.md
|
|
│ ├── OP_04_ANALYZE_RESULTS.md
|
|
│ ├── OP_05_EXPORT_TRAINING_DATA.md
|
|
│ └── OP_06_TROUBLESHOOT.md
|
|
│
|
|
├── system/ # Layer 3: Core specifications
|
|
│ ├── SYS_10_IMSO.md
|
|
│ ├── SYS_11_MULTI_OBJECTIVE.md
|
|
│ ├── SYS_12_EXTRACTOR_LIBRARY.md
|
|
│ ├── SYS_13_DASHBOARD_TRACKING.md
|
|
│ └── SYS_14_NEURAL_ACCELERATION.md
|
|
│
|
|
└── extensions/ # Layer 4: Extensibility guides
|
|
├── EXT_01_CREATE_EXTRACTOR.md
|
|
├── EXT_02_CREATE_HOOK.md
|
|
├── EXT_03_CREATE_PROTOCOL.md
|
|
├── EXT_04_CREATE_SKILL.md
|
|
└── templates/
|
|
```
|
|
|
|
---
|
|
|
|
## Key Constraints (Always Apply)
|
|
|
|
1. **Python Environment**: Always use `conda activate atomizer`
|
|
2. **Never modify master files**: Copy NX files to study working directory first
|
|
3. **Code reuse**: Check `optimization_engine/extractors/` before writing new extraction code
|
|
4. **Validation**: Always validate config before running optimization
|
|
5. **Documentation**: Every study needs README.md and STUDY_REPORT.md
|
|
|
|
---
|
|
|
|
## Next Steps After Bootstrap
|
|
|
|
1. If you know the task type → Go to relevant OP_* or SYS_* protocol
|
|
2. If unclear → Ask user clarifying question
|
|
3. If complex task → Read `01_CHEATSHEET.md` for quick reference
|
|
4. If need detailed loading rules → Read `02_CONTEXT_LOADER.md`
|
|
|
|
---
|
|
|
|
## Session Closing Checklist
|
|
|
|
Before ending a session, complete:
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
│ SESSION CLOSING │
|
|
├─────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ 1. VERIFY WORK IS SAVED │
|
|
│ □ All files committed or saved │
|
|
│ □ Study configs are valid │
|
|
│ □ Any running processes noted │
|
|
│ │
|
|
│ 2. RECORD LEARNINGS TO LAC │
|
|
│ □ Any failures and their solutions → failure.jsonl │
|
|
│ □ Success patterns discovered → success_pattern.jsonl │
|
|
│ □ User preferences noted → user_preference.jsonl │
|
|
│ □ Protocol improvements → suggested_updates.jsonl │
|
|
│ │
|
|
│ 3. RECORD OPTIMIZATION OUTCOMES │
|
|
│ □ If optimization completed, record to optimization_memory/ │
|
|
│ □ Include: method, geometry_type, converged, convergence_trial │
|
|
│ │
|
|
│ 4. SUMMARIZE FOR USER │
|
|
│ □ What was accomplished │
|
|
│ □ Current state of any studies │
|
|
│ □ Recommended next steps │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### Session Summary Template
|
|
|
|
```markdown
|
|
# Session Summary
|
|
|
|
**Date**: {YYYY-MM-DD}
|
|
**Study Context**: {study_name or "General"}
|
|
|
|
## Accomplished
|
|
- {task 1}
|
|
- {task 2}
|
|
|
|
## Current State
|
|
- Study: {status}
|
|
- Trials: {N completed}
|
|
- Next action needed: {action}
|
|
|
|
## Learnings Recorded
|
|
- {insight 1}
|
|
|
|
## Recommended Next Steps
|
|
1. {step 1}
|
|
2. {step 2}
|
|
```
|