samkeen

description	Documentation of the `~/.claude/` directory structure for dev journal integration.
research_date	2026-01-01
claude_code_version	2.0.x
sources	Local filesystem analysis + [Official Docs](https://code.claude.com/docs)

Claude Code Data Structures

Overview

samkeen

╭─── Claude Code v2.0.55 ──────────────────────────────────────────────────────╮
│                            │ Tips for getting started                        │
│        Welcome back!       │ Run /init to create a CLAUDE.md file with inst… │
│                            │ ─────────────────────────────────────────────── │
│           ▐▛███▜▌          │ Recent activity                                 │
│          ▝▜█████▛▘         │ No recent activity                              │
│            ▘▘ ▝▝           │                                                 │
│                            │                                                 │
│   Opus 4.5 · Claude API    │                                                 │

samkeen

# Example create PR skill

## Layout
```
skills/create-pr
├── references
│   └── pr-best-practices.md
└── SKILL.md
```

samkeen

Can you add an export trace button to the ui

I'll help you add an export trace button to the UI. Let me first explore the codebase structure to understand the current implementation.

Task
Explore UI codebase structure
Bash
find /home/user/mcp_visualizer -type f -name "*.tsx" -o -name "*.ts" -o -name "*.jsx" -o -name "*.js" | head -30
/home/user/mcp_visualizer/mcp-inspector-app/app/test-module-2/page.tsx
/home/user/mcp_visualizer/mcp-inspector-app/app/demo/page.tsx

samkeen

Review Efficiency Prompt Template

Purpose: This template helps you engineer AI-generated artifacts that are optimized for efficient human review. Based on the principles from "Engineering AI Generated Artifacts for Human Review" (AlteredCraft).

The Core Insight: When AI generates artifacts, the marginal cost of including full context, rationale, and alternatives is minimal—but the review time saved is massive. This template embeds those requirements into your prompts.

Our Approach to Context

Advanced context tools exist (MCP servers, vector databases, ...), but this template takes a simpler path: leveraging AI coding agents' native ability to access file paths and URLs you provide.

samkeen

Of course. Here is the updated constitution with those three principles integrated.

---

Core Philosophy & Architecture 🏛️

• Follow SOLID Principles: Adhere strictly to the five SOLID principles (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion) to create a modular, scalable, and maintainable architecture.
• Explicit is Better than Implicit: Code should be clear and self-evident. Avoid clever tricks or "magic" that hide the underlying logic. The flow of data and control should be easy to follow.
• Simplicity and YAGNI: Prioritize simplicity and adhere to the "You Ain't Gonna Need It" principle. Do not add functionality or complexity until it is actively required.
• Manage State Predictably: Application state must be handled in a centralized and predictable manner. Avoid scattering state logic throughout the codebase. State changes should be explicit and traceable, minimizing side effects and making the application easier to debug.

samkeen

✻ Welcome to Claude Code!

/help for help, /status for your current setup

cwd: /Users/sam/Projects/code_coach

※ Tip: Press Shift+Enter to send a multi-line
message

> lets start the first lesson

samkeen

You are an expert code reviewer tasked with evaluating the fix you've just proposed for a coding issue. Your goal is to objectively assess your own solution, considering both its immediate effectiveness and its long-term implications for the codebase. Maintain a balanced perspective, neither blindly accepting nor rejecting the proposed fix.

You have already proposed an initial fix based on this context. Your task now is to critically evaluate this fix. Follow these steps:

1. Recall your proposed fix.
2. Analyze the fix from multiple perspectives: functionality, maintainability, scalability, and adherence to coding standards.
3. Consider the following aspects: a. Does it solve the immediate problem? b. Is it consistent with best coding practices? c. Does it integrate well with the existing codebase?

samkeen

[Project Name]

Every time you choose to apply a rule(s), explicitly state the rule(s) in the output. You can abbreviate the rule description to a single word or phrase.

Project Context

[Brief description ]

• [more description]
• [more description]
• [more description]

samkeen

# Supply a custom prompt to a LangChain QA Chain
system_template = """Use the following pieces of context to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.

{context}

Question: {question}
Helpful Answer:"""
messages = [
    SystemMessagePromptTemplate.from_template(system_template),
    HumanMessagePromptTemplate.from_template("{question}"),