F-015: Android project getting-started tutorial (GH #53)

README.md

@@ -37,6 +37,15 @@ systems like Buck and Bazel.
 
 [Presentation Link](https://www.beautiful.ai/player/-MLn7RnBBWeh7vePDoDq)
 
+## Getting started
+
+**New to Forma?** Start here:
+
+1. [**Android project tutorial**](docs/GETTING-STARTED.md) — mental model, run the sample, greenfield skeleton, target cheat sheet (F-015 / GH #53)
+2. [Sample app gold standard](docs/SAMPLE-APP.md) — multi-feature layout to copy
+3. [Dependency matrix](docs/DEPENDENCY-MATRIX.md) — what may depend on what
+4. [External deps catalogs](docs/DEPS-CATALOG.md) · [Compose](docs/COMPOSE.md) · [Environment](docs/ENV.md)
+
 Configuration made easy:
 
 ``` gradle
@@ -177,6 +186,8 @@ Jetpack Compose: per-target `compose` flag + `composeWidget` — **F-013**
 ([`docs/COMPOSE.md`](docs/COMPOSE.md)).
 Sample multi-feature gold standard: **F-014**
 ([`docs/SAMPLE-APP.md`](docs/SAMPLE-APP.md)).
+Android getting-started tutorial: **F-015**
+([`docs/GETTING-STARTED.md`](docs/GETTING-STARTED.md)).
 
 Icons made by <a href="https://www.flaticon.com/authors/freepik" title="Freepik">Freepik</a>
 from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a>

TICKETS.md

@@ -22,7 +22,7 @@ Update this file when picking or finishing work. Cron workers must pick the **hi
 | F-012 | done | External deps catalog UX + tooling polish | `library()` + pure generators + GAV validation + unit tests + `docs/DEPS-CATALOG.md` |
 | F-013 | done | Compose support for Android library/ui targets | GH #96; `compose` flags + `composeWidget`; `docs/COMPOSE.md` |
 | F-014 | done | Sample app: gold-standard multi-feature structure | packageName + source-root alignment; `docs/SAMPLE-APP.md`; home/characters pattern |
-| F-015 | todo | Android project tutorial (getting started) | GH #53 |
+| F-015 | done | Android project tutorial (getting started) | GH #53; `docs/GETTING-STARTED.md` + README entry |
 | F-016 | todo | Plugin publish path (Portal user + target publish config) | GH #132, #133 |
 | F-017 | todo | Configuration-time performance pass | GH #106, #42 |
 

docs/ARCHITECTURE.md

@@ -324,6 +324,7 @@ Suggested extraction order (tickets F-020…F-024):
 | ~~AGP 7.4.2 compile vs 8.1.2 runtime~~ (aligned 8.1.2) | F-003 done |
 | ~~CI missing SDK + Java on some jobs~~ (GHA green on PR #153) | F-004 done |
 | ~~Compose flag in settings, limited target support~~ → per-target flags + `composeWidget` | F-013 done |
+| ~~Missing Android getting-started tutorial~~ → [`docs/GETTING-STARTED.md`](GETTING-STARTED.md) | F-015 done |
 | Shared `library` suffix for JVM vs Android library | F-020 |
 | Plugin publish / Portal path | F-016 |
 | Configuration-time cost (includer walk, stores) | F-017 |
@@ -334,13 +335,14 @@ Suggested extraction order (tickets F-020…F-024):
 
 | Goal | Start here |
 |------|------------|
+| New user / first project | [`docs/GETTING-STARTED.md`](GETTING-STARTED.md) |
 | New target type | `AndroidTargets.kt` + new DSL file under `plugins/android/src/main/java/` + validator list |
 | Tighten dep rules | `validator(...)` in that DSL file; update this doc §2.2 |
 | Global SDK/AGP defaults | `androidProjectConfiguration` + sample `application/build.gradle.kts` |
 | External deps UX | `plugins/deps` catalog + `build-dependencies` |
 | Auto module discovery | `includer/` |
 | CI | `.github/workflows/main.yml` |
-| Sample structure | `application/feature/**`, `binary/` |
+| Sample structure | `application/feature/**`, `binary/` · [SAMPLE-APP.md](SAMPLE-APP.md) |
 
 ---