init

Initialize the Guard plugin by:

• Creating .claude/forbidden_paths.txt with default protected patterns
• Creating .claude/file_guardian_config.json with markdown blocking settings
• Creating .claude/quality_config.json with code quality thresholds
• Setting up hooks in .claude/hooks.json
• Making scripts executable

Usage

/guard:init

What Gets Created

1. Blacklist File (.claude/forbidden_paths.txt)

   • Default patterns for sensitive files (.env, secrets/, *.key, etc.)
   • Lock files (package-lock.json, yarn.lock, etc.)
   • Git internals and build artifacts

2. File Guardian Configuration (.claude/file_guardian_config.json)

   • Markdown blocking settings
   • Allowed patterns for documentation

3. Quality Configuration (.claude/quality_config.json)

   • Default file size thresholds for different extensions
   • TODO/FIXME blocking settings

4. Hooks (.claude/hooks.json)

   • PreToolUse hooks for Write/Edit/MultiEdit operations
   • Merges with existing hooks from other plugins

5. Script Permissions

   • Makes all hook scripts executable

Default Protections

File Protection

After initialization, Guard will automatically protect:

• Environment files (.env, .env.*)
• Secrets directory
• Credential files (*.key, *.pem, *credentials*.json)
• Lock files (package-lock.json, pubspec.lock, etc.)
• Git internals (.git/)
• Build artifacts (build/, dist/, node_modules/)
• Unsolicited markdown summaries (SUMMARY.md, RECAP.md)

Code Quality

Guard will enforce:

• File size limits (800 lines for code, 600 for components, 5000 for docs)
• TODO/FIXME/HACK comment blocking
• Architectural best practices

Implementation

${CLAUDE_PLUGIN_ROOT}/scripts/init_plugin.py