---
name: mandu-security
description: |
  Security best practices for Mandu applications. Use when implementing
  authentication, authorization, input validation, or protecting against
  common vulnerabilities. Triggers on guard, auth, CSRF, XSS, or security tasks.
license: MIT
metadata:
  author: mandu
  version: "1.0.0"
---

# Mandu Security

Mandu 애플리케이션의 보안 모범 사례 가이드. slot guard를 통한 인증/인가, 입력 검증, CSRF/XSS 방어, 환경 변수 관리를 다룹니다.

## Agent Workflow Contract

This skill is a Domain addendum. It must not replace `mandu-agent-workflow`.
Use it only after `mandu.agent.plan` selects security, auth, slot, API, or runtime domains.

Canonical workflow step: `plan -> verify -> repair`.

Preferred MCP tools:

| Step | Tools |
|------|-------|
| plan | `mandu.agent.plan`, `mandu.docs.search` |
| apply | `mandu.agent.apply` |
| verify | `mandu.agent.verify`, `mandu.guard.check`, `mandu.contract.validate` |
| repair | `mandu.agent.repair`, `mandu.guard.explain` |

Allowed file edits:

- Auth/session slot logic named in the plan
- Server-only validation and security header configuration
- Environment templates, never secret values

Verification command:

```bash
mandu agent verify --changed --json --write
```

Common failures:

- Exposing secrets through client bundles or sync artifacts
- Changing auth behavior without route/API/slot verification
- Treating guard findings as policy problems before checking source boundaries

Repair path:

```bash
mandu agent repair --from .mandu/agent-verify.json --json
```

## When to Apply

Reference these guidelines when:
- Implementing authentication in slots
- Adding authorization guards
- Validating user input
- Protecting against CSRF/XSS attacks
- Managing secrets and environment variables
- Handling sensitive data

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Authentication | CRITICAL | `sec-auth-` |
| 2 | Input Validation | CRITICAL | `sec-input-` |
| 3 | CSRF/XSS Protection | HIGH | `sec-protect-` |
| 4 | Environment & Secrets | HIGH | `sec-env-` |
| 5 | Data Handling | MEDIUM | `sec-data-` |

## Quick Reference

### 1. Authentication (CRITICAL)

- `sec-auth-guard` - Use guard() for authentication checks
- `sec-auth-session` - Secure session management
- `sec-auth-jwt` - JWT token handling best practices

### 2. Input Validation (CRITICAL)

- `sec-input-validate` - Always validate and sanitize input
- `sec-input-schema` - Use schema validation (Zod, etc.)
- `sec-input-escape` - Escape output to prevent injection

### 3. CSRF/XSS Protection (HIGH)

- `sec-protect-csrf` - CSRF token implementation
- `sec-protect-xss` - XSS prevention techniques
- `sec-protect-headers` - Security headers configuration

### 4. Environment & Secrets (HIGH)

- `sec-env-management` - Environment variable best practices
- `sec-env-no-expose` - Never expose secrets to client

### 5. Data Handling (MEDIUM)

- `sec-data-sanitize` - Sanitize data before storage
- `sec-data-encrypt` - Encrypt sensitive data

## Security Checklist

```
□ Authentication required for protected routes
□ Input validated on server side
□ Output escaped/sanitized
□ CSRF tokens for state-changing operations
□ Security headers configured
□ Secrets in environment variables only
□ No sensitive data in client bundles
```

## How to Use

Read individual rule files for detailed explanations:

```
rules/sec-auth-guard.md
rules/sec-input-validate.md
rules/sec-protect-csrf.md
```
