feat: add ai setup for lite apps

Author: mychidarko

src/themes/leaf3/.leaf/CONTEXT.md

@@ -0,0 +1,90 @@
+<!-- leaf.context v1 -->
+
+# Project Context
+
+This file is the shared memory for this project. Every AI assistant working here — Claude, Codex, Cursor, or anything else — reads it before making changes and writes useful knowledge back when finished. Treat it as the source of truth for goals, decisions, and conventions.
+
+---
+
+## Working With This File
+
+Read this file before performing any task, together with the project's code and the generated Leaf context. Do not ignore the decisions documented here unless the user explicitly overrides them. When uncertain, prefer preserving existing patterns over introducing new ones.
+
+Format rules, so every agent's edits stay compatible:
+
+1. The first line of this file is its format marker. Never remove or edit it.
+2. Sections are `##` headings. Keep them in their current order. Preserve sections you don't recognize — another agent may own them. You may add project-specific sections at the end.
+3. A line wrapped in underscores is a placeholder. If it contains `agent:`, it is an instruction to you: act on it, then replace the line with real content (or delete it if it no longer applies).
+4. Keep entries to a single line each where possible, so edits from different agents merge cleanly.
+5. Never store secrets, keys, or tokens here. Refer to `.env` keys by name only.
+6. Do not duplicate mechanical information (routes, models, structure, modules). That lives in the code and in `leaf context`. This file holds only what the code cannot say: goals, decisions, and the reasoning behind them.
+
+When your work is complete:
+
+1. Add a line to Recent Changes: `* YYYY-MM-DD — what changed (key files)`. Newest first, five entries maximum; fold older entries into Known Decisions or delete them.
+2. If the Current Goal is done, note it in Recent Changes and replace the goal. If you don't know the next goal, ask the user. Exactly one current goal at a time.
+3. Record lasting choices in Known Decisions as `* Decision — reasoning.` A decision without its why gets relitigated by the next agent.
+4. Keep this file concise. Summarize instead of appending indefinitely, remove outdated information, and prefer references to files over copying their contents.
+
+---
+
+## Project Summary
+
+An empty Leaf app: a single `index.php` holding routes and logic, growing only when the product asks for it.
+
+The project focuses on simplicity, maintainability, and AI-assisted development.
+
+---
+
+## Current Goal
+
+_agent: ask the user what this app is for, then replace this line with the goal. This section always describes the one thing the team is actively working on._
+
+---
+
+## Architecture
+
+### General
+
+* Simplicity is preferred over cleverness.
+* Explicit code is preferred over magic.
+* Features should remain easy for humans and AI to understand.
+
+### Structure
+
+* `index.php` is the whole app: routes, handlers, and wiring live there until it earns more structure.
+* Handlers return responses: `fn () => response()->json([...])` for single expressions, `return response()->...` otherwise.
+* Add capability through modules (`leaf install db`, `auth`, ...) instead of hand-rolling infrastructure.
+* When the app outgrows one file, `leaf up` scales it into MVC structure — don't hand-build `app/` folders here.
+
+---
+
+## External Providers
+
+_agent: when the user adopts a provider, replace this line with a yaml block mapping one provider per concern, for example `billing: stripe`, `email: resend-smtp`, `storage: local`._
+
+---
+
+## Coding Conventions
+
+* Keep routes small and readable.
+* Reuse existing abstractions before introducing new ones.
+* Follow existing naming patterns.
+
+---
+
+## Recent Changes
+
+* _agent: no changes yet. Track them here as `* YYYY-MM-DD — what changed (key files)`, newest first, five maximum._
+
+---
+
+## Known Decisions
+
+* This is a lite Leaf app — one `index.php`, deliberately unstructured until the product demands more.
+
+---
+
+## Future Ideas
+
+* _agent: record ideas the user mentions but isn't building yet._

src/themes/leaf3/AGENTS.md

@@ -0,0 +1,13 @@
+# Agent Instructions
+
+Before performing any task:
+
+1. Read `.leaf/CONTEXT.md` for project goals and architectural decisions.
+2. Use Leaf documentation:
+
+- https://leafphp.dev/ai/SKILL.md
+- https://leafphp.dev/llms.txt
+
+3. Inspect the codebase and use `leaf context` when you need a concise map of the application's structure.
+
+4. When your work is complete, update `.leaf/CONTEXT.md`.

tests/commands.test.php

@@ -100,3 +100,14 @@
     // pre-release pin here breaks `leaf create --lite` for everyone
     expect($theme['require']['leafs/leaf'])->toStartWith('^');
 });
+
+test('lite apps are born AI-ready', function () {
+    leaf('create my-app --lite');
+
+    // composer install fails against the shim, but the theme copy happens
+    // first — the AI context files must be in place
+    expect(file_exists(getcwd() . '/my-app/AGENTS.md'))->toBeTrue()
+        ->and(file_exists(getcwd() . '/my-app/.leaf/CONTEXT.md'))->toBeTrue()
+        ->and(file_get_contents(getcwd() . '/my-app/.leaf/CONTEXT.md'))->toContain('<!-- leaf.context v1 -->')
+        ->and(file_exists(getcwd() . '/my-app/.htaccess'))->toBeTrue();
+});