# Workspace Instructions

## Purpose

This is the control repository for the Ansible roles and collection that
deploy the D&D transcript-processing pipeline. It owns cross-repository plans,
decisions, status, and workspace tooling. Each application and Ansible project
is an independent Git repository.

## Required Reading

- Read [the workspace orientation](docs/orientation.md) before selecting,
  inspecting, or modifying a repository. It maps the repositories and defines
  the canonical sources of truth.
- Read [the workspace conventions](docs/conventions.md) before making any
  repository change. They define the workspace-wide rules and route work to
  specialized policy.
- Read [the Ansible house style](docs/ansible.md) before designing,
  implementing, or reviewing Ansible roles or collections, including plans
  that specify such work.
- Read [the testing house style](docs/testing.md) before creating, changing,
  reviewing, or auditing tests, including plans that specify test work.
- Read [the planning policy](docs/planning.md) before preparing a feature
  roadmap or implementation plan or managing an ongoing work stream.