jsoprych/elko-project-wizard repository overview

Tell us in one line what you use elko-project-wizard for and what broke or is missing. Just click the button or open the feedback form⁠ · Open a GitHub issue⁠.

⁠elko-project-wizard

Stop briefing your AI agent from a blank page.

Pick your directives. Compose a profile. Hit Generate. Get a .zip with AGENTS.md, CLAUDE.md, Dockerfile, and more — ready to cd into and start coding.

No LLM required. The default build is 100% template-based — no API keys, no outbound calls.

📖 Full documentation → github.com/jsoprych/elko-docs/elko-project-wizard⁠

🐳 Docker Hub → hub.docker.com/r/jsoprych/elko-project-wizard⁠

⁠Why This Matters

Every time your AI coding agent starts a session, it reads your AGENTS.md or CLAUDE.md to understand the project. A poorly written one wastes tokens on guesswork — the agent re-learns your conventions and hedges every suggestion. A well-engineered one front-loads the context so the agent hits the ground running, produces idiomatic code on the first attempt, and spends your API budget on actual work.

elko-project-wizard builds that file for you — composable, reusable, and ready to drop into any project in under 60 seconds.

⁠Quick Start

docker run -d \
  --name elko-project-wizard \
  -p 8080:8080 \
  -v wizard-data:/app/data \
  jsoprych/elko-project-wizard:latest

Open http://localhost:8080⁠ — start the Quick Start Wizard or browse directives immediately.

⁠How It Works

1. Browse Directives Pick from 26+ built-in policies across coding standards, tech stack, visibility, Docker, and workflow.

2. Compose a Profile

Combine directives into a reusable profile — Go + Minimal Deps + Docker + Private — saved for every future project.

3. Generate & Go Download a .zip scaffold. Unzip, git init, open Claude Code or OpenCode — your agent is already briefed.

⁠Quick Start Wizard — 5 Steps

Click 🚀 Quick Start Wizard in the sidebar. The wizard walks you through 5 tabs in order — each tab unlocks only after the previous step is complete:

A live checklist sidebar tracks your progress through each step.

⁠What's in the ZIP

⁠Stats

⁠With AI Assist (Optional)

Pass your Anthropic or DeepSeek API key to generate custom directives directly from the dashboard:

docker run -d \
  --name elko-project-wizard \
  -p 8080:8080 \
  -v wizard-data:/app/data \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  jsoprych/elko-project-wizard:latest

Without a key, AI Assist returns a prompt sandwich — paste it into Claude, ChatGPT, Grok, or DeepSeek and import the result as a custom directive.

⁠Docker Compose

services:
  elko-project-wizard:
    image: jsoprych/elko-project-wizard:latest
    ports:
      - "8080:8080"
    volumes:
      - wizard-data:/app/data
    restart: unless-stopped

volumes:
  wizard-data:

⁠Stop / Remove

docker stop elko-project-wizard
docker start elko-project-wizard
docker rm elko-project-wizard                                          # remove container (data kept)
docker rm elko-project-wizard && docker volume rm wizard-data          # full removal

⁠Platforms

linux/amd64 · linux/arm64

Built by Elko.AI⁠ & DARKFABRIK.AI⁠ · [email protected]⁠