How to create new projects using blueprints from the project-blueprints repo. Follow when the user asks to create, scaffold, or initialize a new project.
This is a strict guideline. Follow these rules exactly.
New projects are created from blueprints stored at loxosceles/project-blueprints on GitHub.
~/.devcontainer-state/.git exists. If it doesn't, stop immediately and instruct:
⛔ ~/.devcontainer-state is not a git repo.
Docker will auto-create mount targets as empty root-owned directories, breaking the devcontainer.
Fix: git clone [email protected]:loxosceles/devcontainer-state.git ~/.devcontainer-state
If ~/.devcontainer-state already exists (empty/root-owned), remove it first:
sudo rm -rf ~/.devcontainer-state
blueprints/{stack}.md in the repo.project_name, git_name, git_email, and any other values the blueprint requires.fragments/ are exact configs. Copy them, then replace {{template_variables}} with actual values.fragments/common/) contain {{INJECTION_MARKERS}}. Read the matching injection snippets from fragments/injections/{stack}/ and insert them at the marked points. Pick the Dockerfile from fragments/dockerfiles/{stack}/. The result is one clean file per output — no runtime includes or sourcing. For devcontainer.json, merge the injection's extensions and settings into the common base.npx skills add loxosceles/ai-dev --agent claude-code github-copilot codex kiro-cli -y and ask about additional third-party skills.PROJECT=<project-name>
mkdir -p ~/.devcontainer-state/cache/${PROJECT}/claude
mkdir -p ~/.devcontainer-state/cache/${PROJECT}/kiro/agents
mkdir -p ~/.devcontainer-state/cache/${PROJECT}/kiro/settings
~/.devcontainer-state/ai/agents/kiro/ into ~/.kiro/agents/ by post_create.sh on first run. They persist in the per-project kiro cache mount.~/.devcontainer-state/ai/agents/codex/ into .github/agents/ by post_create.sh on every container start. .github/agents/ is gitignored.KIRO_AGENTS and CODEX_AGENTS env vars in .devcontainer/.env..kiro/agents/ — that causes conflicts with the host's global ~/.kiro/agents/.~/.devcontainer-state/ai/mcp/servers.json exists. If not, warn the user to copy from servers.json.template. MCP servers are distributed to all agents (Kiro, Claude, Amazon Q) by post_start.sh on every container start.post_create.sh — runs once after container creation (validation, symlinks, git identity, agent seeding, skills restore)post_start.sh — runs on every container start (Claude CLI install/update, Claude settings copy, MCP server distribution)[email protected]:user/repo.git{{double_braces}} syntaxproject-migration: This skill and project-migration must produce identical results for shared concerns (devcontainer, skills, kiro, linting, CI/CD). If you detect a discrepancy between what this skill instructs and what project-migration does, stop and warn the developer before proceeding.If the developer corrects a behavior that this skill should have prevented, suggest a specific amendment to this skill to prevent the same correction in the future.