# CodeCanyon AI System kit — MANIFEST

A copy-paste kit that stands up the **AI System** (Phase 1) for a fresh CodeCanyon
Laravel app: the cross-tool constitution, Claude config + permission modes + safety
hooks, the universal rule set, and the other-IDE wiring. Standalone — no external paths.

## How to use

1. Copy the **contents** of this folder into your project root.
2. From the project root: `bash seed.sh` (renames `dot-*` → real dotfiles, seeds rules).
3. Follow the printed manual steps (fill `<placeholders>`, pick a mode, **restart**).

> The `dot-` prefix exists because static hosts and downloads mangle leading-dot files.
> `seed.sh` restores them (`dot-claude/` → `.claude/`, `dot-mcp.json` → `.mcp.json`, etc.).

## Contents

| Path (in kit) | Becomes | What it is |
|---|---|---|
| `AGENTS.md` | `AGENTS.md` | Cross-tool constitution (canonical, committed) |
| `CLAUDE.md` | `CLAUDE.md` | Thin pointer → AGENTS.md (committed) |
| `CLAUDE.local.md.example` | `CLAUDE.local.md` | Personal env (gitignored) — copy + fill |
| `dot-mcp.json` | `.mcp.json` | Project MCP servers (Laravel Boost) |
| `dot-cursor/rules/000-boot.mdc` | `.cursor/rules/000-boot.mdc` | Cursor boot rule → constitution |
| `dot-cursorignore` | `.cursorignore` | Keeps secrets/heavy dirs out of Cursor's index |
| `dot-claude/settings.json` | `.claude/settings.json` | Project-wide settings (committed) — trim MCP list |
| `dot-claude/settings.local.json.example` | `.claude/settings.local.json` | Personal mode (gitignored) — generate via switcher |
| `dot-claude/dot-gitignore` | `.claude/.gitignore` | Ignores `settings.local.json` + backups |
| `dot-claude/rules/feedback_*.md` `reference_*.md` | `.claude/rules/…` | Universal rule set (32 files) |
| `dot-claude/rules/project_context.md.template` | `.claude/rules/project_context.md` | Project-specific context — fill it |
| `dot-claude/rules/seed-project-rules.sh` | `.claude/rules/seed-project-rules.sh` | Idempotent rules seeder/indexer |
| `dot-claude/skills/` | `.claude/skills/` | Install the deploy orchestrator + stack skills here |
| `dot-claude/commands/deploy-codecanyon.md` | `.claude/commands/…` | Deploy orchestrator (stub — replace with full) |
| `dot-claude/hooks/vendor-edit-reminder.sh` | `.claude/hooks/…` | Advisory PostToolUse vendor-edit guard |
| `dot-claude/agents/` | `.claude/agents/` | Project subagents (empty by default) |
| `dot-claude/claude-mode/**` | `.claude/claude-mode/**` | Switcher + block-destructive hook + 3 presets |
| `seed.sh` | — | The installer (run once, then delete if you like) |

## Committed vs gitignored

| Committed (team-shared) | Gitignored (personal) |
|---|---|
| `AGENTS.md`, `CLAUDE.md`, `.mcp.json`, `.cursor/`, `.cursorignore` | `CLAUDE.local.md` |
| `.claude/settings.json`, `.claude/rules/`, `.claude/skills/`, `.claude/hooks/`, `.claude/claude-mode/`, `.claude/agents/` | `.claude/settings.local.json`, `*.bak.*` |

## Provenance

Derived from the CodeCanyon Laravel deployment guides (Phase 1A machine setup + Phase 1B
project setup + the rule/skill templates). All project-specific names and absolute paths
were genericized to `<placeholders>` so the kit is fully standalone.