mandu-security
Security best practices for Mandu applications. Use when implementing authentication, authorization, input validation, or protecting against common vulnerabilities. Triggers on guard, auth, CSRF, XSS,
SKILL.mddocs/archive/skills/mcp-v0/mandu-security/SKILL.md
GitHubMandu 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:
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:
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 checkssec-auth-session- Secure session managementsec-auth-jwt- JWT token handling best practices
2. Input Validation (CRITICAL)
sec-input-validate- Always validate and sanitize inputsec-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 implementationsec-protect-xss- XSS prevention techniquessec-protect-headers- Security headers configuration
4. Environment & Secrets (HIGH)
sec-env-management- Environment variable best practicessec-env-no-expose- Never expose secrets to client
5. Data Handling (MEDIUM)
sec-data-sanitize- Sanitize data before storagesec-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