---
project_key: tactility
status: active
factory_maturity: discovery
updated: 2026-08-17
---

# Tactility — Project Definition

## Purpose

Tactility is the ESP32 platform and runtime-app collection for family displays, audio, media, device interfaces, and approved hardware experiments.

## Execution map

| Host / target | Repository / service | Paseo-project role | Status |
|---|---|---|---|
| Mac mini `.102` | `~/Projects/electronics/tactility/tactility`, Gitea origin | `Tactility · Platform` | Registered local workspace `wks_f6a631c20313f1a8` on `main` |
| Mac mini `.102` | `~/Projects/electronics/tactility/tactility_apps`, Gitea origin | `Tactility · Apps` | Registered local workspace `wks_c488f281bcb459c7` on `main`; detailed app build/deploy guidance is in repo `AGENTS.md` |
| ESP32 fleet | Boards such as `.112`, `.111`, `.123` | Target environments, not Paseo hosts | Device health/version must be verified per task |

## Personas

- Firmware/app planner: read-only, identifies board/SDK/app compatibility.
- Platform or app implementer: isolated worktree only.
- Build verifier: confirms build plus undefined-symbol check.
- Hardware reviewer: assesses firmware/device risk and deployment prerequisites.
- Device QA: captures approved behavioral/screenshot evidence after deployment.
- Deployment executor: performs a specific approved device install/run only.

## Safety boundaries

- Build success alone is not completion.
- Hardware deployment requires explicit approval, named board, compatible SDK/firmware, rollback/recovery plan, and behavior verification.
- Do not blindly flash firmware, mass-install apps, or assume a remembered IP/device identity.

## Factory readiness next actions

1. Discover project-specific build/test commands for platform and apps.
2. Register two separate Mac mini Paseo workspaces.
3. Create repository-specific Paseo script contracts.
4. Pilot an app-only worktree change with build + symbol verification, without device installation.

## Related records

- `../tactility_voice_gateway_elato_transition_2026.md`
- `../../areas/operations/services_inventory.md`