Skillintermediate

🙋‍♀️ Layer 1: User Layer

Claude Code Knowledge Pack7/10/2026

Overview

🏠 Home › 🔧 Implementation › 🏛️ Architecture › 🙋‍♀️ Layer 1: User

← Architecture ━━●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🐔 Main Agent Layer →

</div>

🙋‍♀️ Layer 1: User Layer

Entry point for all interactions with the system.

Purpose

The User Layer is where all human interaction begins. It normalizes various input types before they reach the 🐔 Main Agent.

Components

Component	Emoji	Description	Example
Natural Language	🙋‍♀️	Free-form requests	"Fix the authentication bug"
Slash Commands	🦴	Structured invocations	`/generate fr-FR`
File References	📁	Code/doc references	`@src/auth.ts`

Diagram

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart LR
    classDef user fill:#6366f1,stroke:#4f46e5,stroke-width:2px,color:#ffffff
    classDef main fill:#8b5cf6,stroke:#7c3aed,stroke-width:2px,color:#ffffff

    subgraph UserLayer["🙋‍♀️ USER LAYER"]
        NL["🙋‍♀️📥 Natural Language<br>'Fix the bug'"]:::user
        SC["🦴 /command args"]:::user
        FR["📁 @file/path"]:::user
    end

    NL --> MA["🐔 Main Agent"]:::main
    SC --> MA
    FR --> MA

    classDef userBox fill:#e0e7ff,stroke:#6366f1,stroke-width:2px,color:#3730a3

    UserLayer:::userBox

Key Behaviors

All input normalized before reaching 🐔 Main Agent
🦴 Slash commands expand to full prompts
File references inject content

Input Types

🙋‍♀️📥 Natural Language

"Fix the authentication bug in the login module"
"Add dark mode support to the settings page"
"Refactor the payment service for better performance"

Free-form requests that Claude interprets and routes appropriately.

🦴 Slash Commands

/generate fr-FR          # Single locale
/generate fr es de       # Multiple locales
/review-pr 123          # Review PR
/deploy staging         # Deploy to environment

Structured commands that expand to predefined prompts with $ARGUMENTS substitution.

📁 File References

@src/auth.ts            # Reference specific file
@package.json           # Reference config file
@docs/api.md           # Reference documentation

File contents are injected into context for the 🐔 Main Agent.

Layer Position

┌─────────────────────────────────────────────────────┐
│  🙋‍♀️ LAYER 1: USER LAYER  ◄─── YOU ARE HERE       │
│  Human input, 🦴 /commands, natural language        │
└─────────────────────────┬───────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│  🐔 LAYER 2: MAIN AGENT LAYER                       │
│  Claude Code - orchestration, decision-making       │
└─────────────────────────────────────────────────────┘

← Architecture ━━●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🐔 Main Agent Layer →

</div>