Menu
Show StrayMark documentation status. Use to verify if AI agents properly documented their changes.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | straymark-status |
| description | Show StrayMark documentation status. Use to verify if AI agents properly documented their changes. |
| allowed-tools | Read, Glob, Bash(git diff *, git log *, git status *, date *, straymark analyze *) |
This skill checks the documentation status of the StrayMark in the current project.
When invoked, perform the following checks and display the results:
Search for StrayMark documents created or modified in the last hour:
# Get documents modified in the last hour
git log --since="1 hour ago" --name-only --pretty=format: -- ".straymark/**/*.md" | sort -u | grep -v "^$"
If git is not available or the directory is not a git repo, use file modification times. Check these directories for each document type:
| Type | Prefix | Directory |
|---|---|---|
| AILOG | AILOG- | .straymark/07-ai-audit/agent-logs/ |
| AIDEC | AIDEC- | .straymark/07-ai-audit/decisions/ |
| ADR | ADR- | .straymark/02-design/decisions/ |
| ETH | ETH- | .straymark/07-ai-audit/ethical-reviews/ |
| REQ | REQ- | .straymark/01-requirements/ |
| TES | TES- | .straymark/04-testing/ |
| INC | INC- | .straymark/05-operations/incidents/ |
| TDE | TDE- | .straymark/06-evolution/technical-debt/ |
| SEC | SEC- | .straymark/08-security/ |
| MCARD | MCARD- | .straymark/09-ai-models/ |
| SBOM | SBOM- | .straymark/07-ai-audit/ |
| DPIA | DPIA- | .straymark/07-ai-audit/ethical-reviews/ |
Also enumerate Charters (bounded units of work — distinct from doc types; see STRAYMARK.md §15):
# Charters list with status counts (declared / in-progress / closed)
straymark charter list 2>/dev/null
If the project has no Charters yet but the work clearly fits the trigger (multi-session implementation block, >5 tasks across phases, audit value), surface that as a gap in the Display Results step and recommend /straymark-charter-new.
Identify source files that were modified and might need documentation:
# Get modified files (staged and unstaged)
git diff --name-only HEAD~1..HEAD 2>/dev/null || git diff --name-only
Filter to show only files that might need documentation:
*.md, *.json, *.yml, *.yaml, *.lock, package-lock.json*.ts, *.js, *.tsx, *.jsx, *.py, *.go, *.rs, *.java, *.cs, *.rb, *.phpRun complexity analysis on modified source files:
# Analyze complexity of changed files (primary method for AILOG trigger)
straymark analyze --output json 2>/dev/null
# If CLI unavailable, fall back to line count heuristic in step 3
For each modified source file, check if there's a corresponding StrayMark document:
straymark analyze reports summary.above_threshold > 0; fallback if CLI unavailable: >20 lines of business logic) should have an AILOGpackage.json, Cargo.toml, go.mod, etc.) should have an SBOM.straymark/charters/Format the output as follows:
StrayMark Status
================================================================================
Recent Documents (last hour):
[checkmark] AILOG-2025-01-27-001-implement-auth.md
[checkmark] AIDEC-2025-01-27-001-auth-strategy.md
Modified Files Without Documentation:
[warning] src/auth/login.ts (cognitive: 12, threshold: 8)
[warning] src/api/users.ts (cognitive: 9, threshold: 8)
Summary:
Documents created: 2
Files needing review: 2
Use /straymark-status after making changes to verify documentation compliance.
[checkmark] = Documentation exists (use checkmark symbol)[warning] = May need documentation (use warning symbol)[info] = Informational (use info symbol)Create an ADR (Architecture Decision Record) for significant architectural decisions. Requires human review.
Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.
Create an AILOG (AI Action Log) document for the current changes. Quick shortcut for the most common document type.
Execute an external audit of a Charter inside an auditor-side CLI (gemini-cli, claude-cli, copilot-cli, codex-cli). Reads the resolved audit prompt from the canonical location, audits with tool use, writes the report. Operator invokes one instance per CLI.
Generate the unified audit prompt for a Charter at the canonical filesystem location. The operator then opens N auditor-side CLIs (gemini-cli, claude-cli, copilot-cli, etc.) and invokes /straymark-audit-execute in each — no copy/paste. Counterpart of /straymark-audit-review.
Consolidate N external auditor reports into a critical review document with verdicts, remediation plan, and auditor ratings. Then merge the external_audit YAML block into the Charter telemetry. Counterpart of /straymark-audit-prompt and /straymark-audit-execute.