---
title: "🙋‍♀️ Layer 1: User Layer"
description: "<div align=\"center\">"
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/01-user-layer
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T10:58:42.779Z
license: CC-BY-4.0
attribution: "🙋‍♀️ Layer 1: User Layer — Claudary (https://claudary.paisolsolutions.com/skills/01-user-layer)"
---

# 🙋‍♀️ Layer 1: User Layer
<div align="center">

## Overview

<div align="center">

[🏠 Home](../../README.md) › [🔧 Implementation](../README.md) › [🏛️ Architecture](./) › **🙋‍♀️ Layer 1: User**

[← Architecture](./) ━━●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [🐔 Main Agent Layer →](02-main-agent-layer.md)

</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

```mermaid
%%{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       │
└─────────────────────────────────────────────────────┘
```

---

<div align="center">

[← Architecture](./) ━━●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [🐔 Main Agent Layer →](02-main-agent-layer.md)

</div>

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/01-user-layer) · https://claudary.paisolsolutions.com