# AI Wiki — Quick Index

Read this file first to find the right document. Do NOT load the entire ai-wiki/ folder into context.

## Skills (use when creating/modifying contracts)

| When you need to...                      | Read                                             |
| ---------------------------------------- | ------------------------------------------------ |
| Create a .datasource.xml                 | `ai-wiki/skills/create-datasource/SKILL.md`      |
| Create a .businessobject.xml             | `ai-wiki/skills/create-business-object/SKILL.md` |
| Create a .listobject.xml / .listitem.xml | `ai-wiki/skills/create-list-object/SKILL.md`     |
| Create a .processflow.xml                | `ai-wiki/skills/create-process/SKILL.md`         |
| Create a .userinterface.xml              | `ai-wiki/skills/create-ui-page/SKILL.md`         |
| Create a .bl.js business logic file      | `ai-wiki/skills/create-business-logic/SKILL.md`  |
| Create a .lookupobject.xml               | `ai-wiki/skills/create-lookup-object/SKILL.md`   |
| Create a .printlayoutv2.xml              | `ai-wiki/skills/create-print-layout/SKILL.md`    |
| Add a cockpit card (home screen)         | `ai-wiki/skills/add-cockpit-card/SKILL.md`       |
| Add a calendar/planner view              | `ai-wiki/skills/add-calendar-view/SKILL.md`      |
| Add a detail/edit screen                 | `ai-wiki/skills/add-detail-screen/SKILL.md`      |
| Add a list/search screen                 | `ai-wiki/skills/add-list-screen/SKILL.md`        |
| Build, validate, simulate                | `ai-wiki/skills/build-and-simulate/SKILL.md`     |
| Check if a SQLite column exists          | `ai-wiki/skills/verify-sqlite-schema/SKILL.md`   |

## Architecture (use when understanding how layers work)

| When you need to understand...               | Read                                           |
| -------------------------------------------- | ---------------------------------------------- |
| How Salesforce fields map to app attributes  | `ai-wiki/architecture/datasource-layer.md`     |
| Entity lifecycle, child objects, persistence | `ai-wiki/architecture/businessobject-layer.md` |
| Collections, aggregation, facades            | `ai-wiki/architecture/listobject-layer.md`     |
| Workflow orchestration, decisions, actions   | `ai-wiki/architecture/process-layer.md`        |
| Responsive UI layout, controls, bindings     | `ai-wiki/architecture/ui-layer.md`             |
| End-to-end data flow (SF → SQLite → UI)      | `ai-wiki/architecture/integration-flow.md`     |
| Build system, Jest tests, validation         | `ai-wiki/architecture/testing-and-build.md`    |

## Patterns & Reference

| When you need to...                         | Read                                                      |
| ------------------------------------------- | --------------------------------------------------------- |
| Choose declarative vs scripted DS           | `ai-wiki/patterns/datasource-patterns.md`                 |
| Implement a cockpit card (7-step checklist) | `ai-wiki/patterns/cockpit-card-checklist.md`              |
| Check naming conventions (PascalCase etc.)  | `ai-wiki/reference/naming-conventions.md`                 |
| **Understand control dependencies**         | **`ai-wiki/patterns/ui-control-dependencies.md`** ⭐ NEW |
| **Troubleshoot build errors fast**          | **`ai-wiki/reference/build-error-quick-reference.md`** ⭐ NEW |
| **Manage locale labels and translations**   | **`ai-wiki/reference/locale-label-resolution.md`** ⭐ NEW |

## Wiki (deep-dive concept articles)

| Topic                   | Read                                      |
| ----------------------- | ----------------------------------------- |
| Architecture overview   | `ai-wiki/wiki/architecture-overview.md`   |
| Business logic (.bl.js) | `ai-wiki/wiki/business-logic.md`          |
| Business objects        | `ai-wiki/wiki/business-objects.md`        |
| Calendar control        | `ai-wiki/wiki/calendar-control.md`        |
| Cockpit cards           | `ai-wiki/wiki/cockpit-cards.md`           |
| Customer detail screens | `ai-wiki/wiki/customer-detail-screens.md` |
| DataSource              | `ai-wiki/wiki/datasource.md`              |
| List objects            | `ai-wiki/wiki/list-objects.md`            |
| Module architecture     | `ai-wiki/wiki/module-architecture.md`     |
| Offline sync patterns   | `ai-wiki/wiki/offline-sync.md`            |
| Print layouts           | `ai-wiki/wiki/print-layouts.md`           |
| Processes               | `ai-wiki/wiki/processes.md`               |
| User interface          | `ai-wiki/wiki/user-interface.md`          |
| All topics (full list)  | `ai-wiki/wiki/index.md`                   |

## Agents

| When you need to...                         | Read                                   |
| ------------------------------------------- | -------------------------------------- |
| Understand the spec-driven dev agent config | `ai-wiki/agents/cgmobile-dev-agent.md` |

## How to Use This Index

1. **Find your task** in the tables above
2. **Read only the file listed** — it contains everything needed for that task
3. **Skills reference sub-files** — each SKILL.md links to its own `references/` and `templates/` when needed
4. **Do not pre-load multiple files** — read one at a time, on demand