compass-cc 0.1.0

package/templates/BASELINE.md

@@ -0,0 +1,32 @@
+# Project Baseline
+
+Snapshot generated on: ${DATE}
+Project root: ${PROJECT_ROOT}
+
+## Project structure
+
+${STRUCTURE}
+
+## Languages and frameworks
+
+${LANGUAGES}
+
+## Dependencies
+
+${DEPENDENCIES}
+
+## Existing documentation
+
+${DOCUMENTATION}
+
+## Observed patterns
+
+${PATTERNS}
+
+## Git history summary
+
+${GIT_HISTORY}
+
+## Open questions for framing
+
+${OPEN_QUESTIONS}

package/templates/FRAMING.md

@@ -0,0 +1,51 @@
+# Project Framing
+
+Produced by `/compass:frame` on: ${DATE}
+
+---
+
+## Mission
+
+What is this project trying to achieve? Why does it exist?
+
+${MISSION}
+
+## Scope
+
+### In scope
+
+${IN_SCOPE}
+
+### Out of scope
+
+${OUT_OF_SCOPE}
+
+## Constraints
+
+Technical, resource, time, knowledge, or domain constraints that shape the project.
+
+${CONSTRAINTS}
+
+## Non-goals
+
+What this project deliberately does NOT try to do.
+
+${NON_GOALS}
+
+## Success criteria
+
+How will you know the project succeeded?
+
+${SUCCESS_CRITERIA}
+
+## Risks
+
+What could go wrong? What are you most uncertain about?
+
+${RISKS}
+
+## Prior art
+
+Similar projects, what they did well, what they did poorly.
+
+${PRIOR_ART}

package/templates/RESEARCH-DOSSIER.md

@@ -0,0 +1,36 @@
+# Research Dossier: ${TOPIC}
+
+Researched on: ${DATE}
+Relevance to project: ${RELEVANCE}
+
+## Question
+
+${QUESTION}
+
+## Context
+
+${CONTEXT}
+
+## Findings
+
+### ${SUBTOPIC_1}
+
+${FINDINGS_1}
+
+## Trade-offs
+
+| Approach | Advantages | Disadvantages | Source |
+|----------|-----------|---------------|--------|
+| ${APPROACH} | ${ADVANTAGES} | ${DISADVANTAGES} | ${SOURCE} |
+
+## Risks
+
+${RISKS}
+
+## Open questions
+
+${OPEN_QUESTIONS}
+
+## Sources
+
+1. [${TITLE}](${URL}) — accessed ${DATE}

package/templates/SESSION.md

@@ -0,0 +1,23 @@
+# COMPASS Session State
+
+Last updated: ${TIMESTAMP}
+
+## Current phase
+
+${PHASE}
+
+## Phase progress
+
+${PROGRESS}
+
+## Recent decisions
+
+${DECISIONS}
+
+## Stopped at
+
+${STOPPED_AT}
+
+## Next recommended action
+
+${NEXT_ACTION}

package/templates/SPEC.md

@@ -0,0 +1,40 @@
+# Specification
+
+Produced by `/compass:spec` on: ${DATE}
+
+## Overview
+
+${OVERVIEW}
+
+## Module: ${MODULE_NAME}
+
+### ${BEHAVIOR_NAME}
+
+**Description**: ${DESCRIPTION}
+
+**Preconditions**: ${PRECONDITIONS}
+
+**Postconditions**: ${POSTCONDITIONS}
+
+**Error cases**:
+- ${ERROR_CONDITION}: ${ERROR_BEHAVIOR}
+
+**Boundary conditions**:
+- ${BOUNDARY}: ${BOUNDARY_BEHAVIOR}
+
+**Invariants**: ${INVARIANTS}
+
+**Acceptance criteria**:
+- [ ] Given ${X}, when ${Y}, then ${Z}
+
+**Related**: ADR-${NNN}, ARCHITECTURE.md § ${SECTION}
+
+## System-wide invariants
+
+${SYSTEM_INVARIANTS}
+
+## Related artifacts
+
+- ARCHITECTURE.md — structural context
+- ADR/ — decisions that constrain behavior
+- FRAMING.md — mission and scope

package/templates/UNIT.md

@@ -0,0 +1,33 @@
+# Unit ${NNN}: ${TITLE}
+
+## Status
+
+pending
+
+## Description
+
+${DESCRIPTION}
+
+## Acceptance criteria
+
+- [ ] ${CRITERION_1}
+- [ ] ${CRITERION_2}
+
+## Dependencies
+
+- unit-${NNN}: ${TITLE} — ${WHY}
+
+## Scope boundaries
+
+**In scope**: ${IN_SCOPE}
+**Out of scope**: ${OUT_OF_SCOPE}
+
+## Related artifacts
+
+- SPEC.md § ${SECTION}
+- ADR-${NNN}: ${TITLE}
+- ARCHITECTURE.md § ${SECTION}
+
+## Open questions
+
+- ${QUESTION}

package/templates/config.yaml

@@ -0,0 +1,23 @@
+# COMPASS configuration — generated by /compass:init
+version: 1
+
+paths:
+  adr: ".compass/ADR"
+  spec: ".compass/SPEC.md"
+  research: ".compass/RESEARCH"
+  units: ".compass/UNITS"
+
+project:
+  language: "${LANGUAGE}"
+  git_tracked: ${GIT_TRACKED}
+
+hooks:
+  scope_guardian: ${SCOPE_GUARDIAN}
+  commit_check: ${COMMIT_CHECK}
+  context_monitor: true
+
+style:
+  socratic_level: "${SOCRATIC_LEVEL}"
+
+session:
+  auto_log: true