Merge pull request #321 from CERTCC/hexagonal-refactor

Hexagonal refactor

Author: ahouseholder

.github/skills/format-code-run-tests/SKILL.md

@@ -0,0 +1,36 @@
+# Skill: Format code & run tests
+
+Purpose
+
+Describe how to run Black and the canonical project test command for Vultron.
+
+Commands (run in zsh, from repository root)
+
+Format code (pre-commit enforces Black):
+
+```bash
+uv run black vultron/ test/
+```
+
+Run the full test-suite — EXACTLY this command, EXACTLY ONCE per validation cycle:
+
+```bash
+uv run pytest --tb=short 2>&1 | tail -5
+```
+
+Notes
+
+- Read the last 5 lines for the summary and any short failure tracebacks.
+- Do NOT re-run pytest to grep counts, do not use -q, and do not change the tail window (e.g., tail -3 or tail -15).
+- Run Black after editing any Python files and before staging for commit.
+- Do NOT run Black on markdown files (use markdownlint-cli2 for those).
+
+Running a specific test file:
+
+```bash
+uv run pytest test/test_semantic_activity_patterns.py -v
+```
+
+Rationale
+
+These commands are the canonical, repo-authoritative steps recorded in AGENTS.md for formatting and validating changes before committing.

.markdownlint-cli2.yaml

@@ -23,15 +23,17 @@ config:
   # Force asterisk style for strong
   "MD050":
     style: "asterisk"
+  # 024 No duplicate headings
+  # Allow duplicate headings as long as they don't share the same parent section
+  "MD024":
+    siblings_only: true
   # 051 Link fragments should be valid
   # Disabled because conversion from TeX to markdown produces invalid links
   # We might eventually be able to re-enable this one.
   "MD051": false
   # 060 - Table column style
   "MD060": false
 ignores:
-  - "plan/**"
-  - "specs/**"
   - "wip_notes/**"
-  - "AGENTS.md"
   - "node_modules/**"
+  - ".github/**"

.markdownlintignore

@@ -1,6 +1,3 @@
-plan/
-specs/
-prompts/
 wip_notes/
 node_modules/
-AGENTS.md
+.github/