Unify OpenCode and Codex starter kits

- Add .shared/prompts/ with tool-neutral prompts - Add .opencode/config/project.md, rules/, skills/ from opencode-kit - Add .codex/config/project.md from codex-kit - Copy .shared/prompts/ to both .opencode/prompts/ and .codex/prompts/ - Add features/INDEX.md and features/README.md - Update README with unified structure The two original starter kits are now redundant.
2026-05-25 14:11:00 +02:00
parent 2d4dbe48e9
commit 5c9b4333da
38 changed files with 1659 additions and 107 deletions
--- a/README.md
+++ b/README.md
@@ -9,41 +9,61 @@ skeleton/
 ├── .git/                    # Git Repository
 ├── .gitignore
 ├── AGENTS.md                # opencode-cli Kontext
-├── .opencode/               # opencode-cli Konfiguration (optional)
-│   ├── settings.json
+├── .opencode/               # OpenCode-Konfiguration
+│   ├── config/
+│   │   └── project.md       # Projekt-spezifische Config
 │   ├── rules/
-│   │   ├── general.md
 │   │   ├── backend.md
+│   │   ├── database.md
 │   │   ├── frontend.md
+│   │   ├── general.md
+│   │   ├── php.md
 │   │   └── security.md
-│   └── skills/
-│       └── help/SKILL.md
+│   ├── skills/              # OpenCode Skills
+│   │   ├── architecture/
+│   │   ├── backend/
+│   │   ├── deploy/
+│   │   ├── docs/
+│   │   ├── frontend/
+│   │   ├── php/
+│   │   ├── qa/
+│   │   └── requirements/
+│   └── prompts/             # Kopie von .shared/prompts
+├── .codex/                  # Codex-Konfiguration
+│   ├── config/
+│   │   └── project.md       # Projekt-spezifische Config
+│   └── prompts/             # Kopie von .shared/prompts
+├── .shared/                  # Gemeinsame Ressourcen
+│   └── prompts/             # Neutralisierte Prompts (tool-unabhängig)
+│       ├── requirements.md
+│       ├── architecture.md
+│       ├── backend.md
+│       ├── frontend.md
+│       ├── qa.md
+│       └── deploy.md
 ├── docs/                    # Dokumentation pro Domain
-│   ├── www.example.com/     # Docs für www.example.com
-│   │   ├── doku/            # Technische Dokumentation
-│   │   ├── planung/         # Planung, Meilensteine
-│   │   └── todos/          # Aufgaben, TODOs
-│   ├── api.example.com/     # Docs für api.example.com
+│   ├── www.example.com/
 │   │   ├── doku/
 │   │   ├── planung/
 │   │   └── todos/
-│   └── app.example.com/     # Docs für app.example.com
+│   ├── api.example.com/
+│   │   ├── doku/
+│   │   ├── planung/
+│   │   └── todos/
+│   └── app.example.com/
 │       ├── doku/
 │       ├── planung/
 │       └── todos/
-├── www/                     # Webroot (deployed auf Server)
-│   ├── www.example.com/     # www.example.com
-│   │   └── public/          # Document Root
-│   │       └── index.php
-│   ├── api.example.com/     # api.example.com
-│   │   └── public/          # Document Root
-│   │       └── index.php
-│   └── app.example.com/     # app.example.com
-│       └── public/          # Document Root
-│           └── index.php
-├── features/                # Feature Specs (optional, von Starter Kit)
+├── features/                # Feature Specs
 │   ├── INDEX.md
-│   └── PROJ-X-*.md
+│   └── README.md
+├── www/                     # Webroot (deployed auf Server)
+│   ├── www.example.com/
+│   │   └── public/
+│   ├── api.example.com/
+│   │   └── public/
+│   └── app.example.com/
+│       └── public/
 └── README.md
 ```

@@ -109,42 +129,43 @@ Skeleton ist flexibel — standardmäßig PHP mit SQLite, anpassbar je nach Proj

 ## Coding Starter Kits

-Für AI-gestütztes Coding gibt es zwei spezialisierte Starter Kits die als Vorlage integriert werden können:
+Die Starter Kits sind im Skeleton vereinheitlicht. Beide Tools nutzen dieselben Prompts aus `.shared/prompts/`.

-### ai-coding-starter-kit-opencode (PHP)
+### .shared/prompts/

-PHP-first Projekt-Kit für OpenCode mit SQLite-dev / MariaDB-Production Ansatz.
+Enthält tool-unabhängige Prompts für alle Development-Phasen:

-**Relevante Dateien die man übernehmen kann:**
- `OPENCODE.md` — Auto-geladenes Projekt-Kontext
+| Prompt | Zweck |
+|--------|-------|
+| `requirements.md` | Feature Specs erstellen |
+| `architecture.md` | Tech Design entwerfen |
+| `backend.md` | Backend implementieren |
+| `frontend.md` | UI bauen |
+| `qa.md` | Testen & verifizieren |
+| `deploy.md` | Produktiv setzen |
+
+### .opencode/
+
+OpenCode-spezifische Konfiguration:
+- `.opencode/config/project.md` — Projekt-Config
 - `.opencode/rules/*.md` — Coding Rules (PHP, Security, Database, etc.)
- `features/INDEX.md`, `features/PROJ-X-*.md` — Feature Tracking
- `docs/production/*.md` — Production Guidelines
- `composer.json` — PHP Dependencies
+- `.opencode/skills/` — OpenCode Skills (autonome Agenten)
+- `.opencode/prompts/` — Kopie von `.shared/prompts/`

-```bash
-# Beispiel: Regeln von opencode-kit übernehmen
-git subtree add --prefix=.opencode https://git.shadow-land.de/madgerm/ai-coding-starter-kit-opencode.git .opencode
-```
+### .codex/

-**Repo:** https://git.shadow-land.de/madgerm/ai-coding-starter-kit-opencode
+Codex-spezifische Konfiguration:
+- `.codex/config/project.md` — Projekt-Config
+- `.codex/prompts/` — Kopie von `.shared/prompts/`

-### ai-coding-starter-kit-codex (TypeScript/Next.js)
+### Eigene Kits behalten oder löschen?

-TypeScript/Next.js Projekt-Kit mit Supabase.
+Die ursprünglichen Starter Kits können gelöscht werden:

-**Relevante Dateien die man übernehmen kann:**
- `features/INDEX.md`, `features/PROJ-X-*.md` — Feature Tracking
- `docs/production/*.md` — Production Guidelines
- `tailwind.config.ts`, `next.config.ts` — Framework Config
- `.opencode/rules/` — Coding Rules
+- ~~https://git.shadow-land.de/madgerm/ai-coding-starter-kit-opencode~~
+- ~~https://git.shadow-land.de/madgerm/ai-coding-starter-kit-codex~~

-```bash
-# Beispiel: Features-Struktur übernehmen
-git subtree add --prefix=features https://git.shadow-land.de/madgerm/ai-coding-starter-kit-codex.git features
-```
-
-**Repo:** https://git.shadow-land.de/madgerm/ai-coding-starter-kit-codex
+Das Skeleton enthält alles was beide brauchen.

 ## Lizenz