ansible-workspace-dnd/README.md

Ansible D&D Development Workspace

This repository coordinates development of the Ansible roles and collection used to deploy the D&D transcript-processing pipeline. The application and Ansible projects remain independent Git repositories; this repository tracks only workspace documentation, planning, and shared development utilities.

Start Here

• AGENTS.md describes repository boundaries and working conventions.
• workspace.yml inventories the repositories used during development.
• docs/roadmap/mvp.md records settled MVP decisions and open design work.
• docs/roadmap/features/ contains durable feature roadmaps for selected units of work.
• docs/status.md records current cross-repository progress.
• docs/roadmap/implementation.md, when present, is the single active out-of-band implementation plan.
• docs/roadmap/implementation-template.md defines its staged format.

Run ./scripts/status to see the branch and working-tree state of every repository in the workspace manifest.

Development Tooling

Create the shared workspace environment on Ubuntu 26.04 with:

sudo apt-get install python3-venv
python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -r requirements-dev.txt

Either activate it with source .venv/bin/activate or invoke tools directly, for example .venv/bin/ansible-playbook and .venv/bin/ansible-lint. Dependency upgrades are deliberate changes to requirements-dev.txt; do not install workspace development packages into the system Python environment.

Repository Boundaries

The directories ignored by this repository are intentional nested Git working trees. Run Git commands from within the repository whose history should be affected. A commit in this control repository never includes changes from an application, role, collection, or proof-of-concept repository.