59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# Workspace Orientation
|
|
|
|
## Repository Map
|
|
|
|
Repositories inside this directory:
|
|
|
|
- `ansible-collection-dnd`: the `rakestraw.dnd` collection that bundles and
|
|
distributes the pipeline suite.
|
|
- `ansible-role-dnd-pipeline`: independent source repository for the
|
|
suite-level role exposed by the collection as `rakestraw.dnd.pipeline`.
|
|
- `ansible-role-{narratio,notarius,audita,seriatim,scriptorium}`: standalone
|
|
application roles.
|
|
- `assets/campaigns`: D&D campaign registry content deployed by the pipeline
|
|
role.
|
|
- `assets/narratio-prompts`: PromptKit-compatible prompts and schemas deployed
|
|
for Scriptorium by the pipeline role.
|
|
- `assets/configs`: snapshots of application configuration from a test machine;
|
|
treat them as non-authoritative operational references that may use obsolete
|
|
syntax or installation-specific values.
|
|
- `rakestraw-ansible`: working deployment repository containing the
|
|
`pipeline_dnd` proof of concept; treat it as read-only reference unless the
|
|
task explicitly includes it.
|
|
|
|
Relevant upstream repositories are siblings of this directory:
|
|
|
|
- `../{narratio,notarius,audita,seriatim,scriptorium}`: application source and
|
|
authoritative application contracts.
|
|
|
|
Use [the workspace inventory](../workspace.yml) as the complete
|
|
machine-readable inventory of paths and remotes.
|
|
|
|
## Sources of Truth
|
|
|
|
- [Workspace conventions](conventions.md): normative workspace-wide rules and
|
|
policy routing.
|
|
- [Ansible house style](ansible.md): normative role, collection, and
|
|
application-configuration practices.
|
|
- [Testing house style](testing.md): normative behavioral-testing practices.
|
|
- [Planning policy](planning.md): normative feature planning and progress
|
|
workflow.
|
|
- [MVP roadmap](roadmap/mvp.md): settled MVP scope, architecture, and open
|
|
design work.
|
|
- [Feature roadmaps](roadmap/features/): durable scope and target state for
|
|
selected units of work.
|
|
- [Workspace status](status.md): current cross-repository progress and next
|
|
work.
|
|
- [Decision records](decisions/): durable rationale for significant
|
|
architectural choices.
|
|
- [Implementation plan](roadmap/implementation.md): the fixed location for the
|
|
active staged plan or, when no plan is approved, a pending-plan notice.
|
|
- Application repositories: CLI, configuration, build, and integration
|
|
contracts.
|
|
- Asset repositories: authoritative campaign and prompt-library content and
|
|
layout.
|
|
- Reference configurations under `assets/configs`: evidence of prior
|
|
operational choices, never an application contract or a source to copy
|
|
verbatim.
|
|
- Individual Ansible repositories: implementation and repository-local tests.
|