Skip to content

Commit c243eed

Browse files
authored
feat(framework+cli): fw-4.15.0 / cli-3.13.2 — inject AGENTS.md universal standard (#155)
* feat(framework): fw-4.15.0 — inject AGENTS.md universal standard Adds AGENTS.md as a first-class injection target. AGENTS.md is the open standard for AI coding agents donated to the Agentic AI Foundation (Linux Foundation, 2025) and read by Claude Code, OpenAI Codex CLI, Cursor, Aider, Devin, Sourcegraph Amp, Google Jules, Zed AI, Continue, Roo Code, Factory Droids, GitHub Copilot, Gemini CLI, Windsurf, Amazon Q and others. Before fw-4.15.0, StrayMark injected directives only into platform-specific files (CLAUDE.md, GEMINI.md, copilot-instructions, .cursorrules, cursor/rules/straymark.md); adopters using any of the other 15+ CLIs had to copy directives by hand. From this release, straymark init and update-framework keep AGENTS.md in sync with STRAYMARK.md automatically. - New template dist/dist-templates/directives/AGENTS.md (reference shape; pointer to STRAYMARK.md plus minimum-viable body for agents that cannot follow relative links) - New injection entry in dist/dist-manifest.yml, placed first as the universal entry point - STRAYMARK.md documents AGENTS.md coexistence with CLI-specific files (different identity strings, same source of truth) - remove.rs legacy fallback updated to clean AGENTS.md for installations that lose .straymark/dist-manifest.yml - Three new integration tests in cli/tests/inject_test.rs: template-has-markers, manifest-declares-injection, coexists-with-preexisting-file - Governance footers and version tables bumped to v4.15.0 across EN + i18n/es + i18n/zh-CN - README and ADOPTION-GUIDE list AGENTS.md as the universal entry point with the full reader-CLI inventory CLI version unchanged (cli-3.13.1 remains the matching version). No behavior change for adopters that already maintain AGENTS.md manually: the injection appends a marker block, preserves existing custom content, and is idempotent. * chore: bump CLI to 3.13.2 for AGENTS.md in remove fallback The data-driven cleanup path in remove.rs already handles AGENTS.md correctly via the manifest read; the previous commit also extended the LEGACY_DIRECTIVE_TARGETS fallback so `straymark remove` cleans AGENTS.md even when the local manifest is missing or fails to parse. That is a behavioral change in the released binary and warrants a matching CLI bump per project versioning policy. - cli/Cargo.toml + Cargo.lock: 3.13.1 → 3.13.2 - CHANGELOG: section header retitled `Framework 4.15.0 / CLI 3.13.2` with a new `### Added (CLI)` subsection documenting the rationale - Version tables and example outputs in README + CLI-REFERENCE (EN + ES + zh-CN) updated to cli-3.13.2 - Adopter guidance reworked to mention update-cli alongside update-framework No behavior change beyond the LEGACY_DIRECTIVE_TARGETS extension already shipped in the previous commit. * docs(cli): add crate-focused README for crates.io listing Crates.io was previously showing a runtime copy of the root README (approximately 650 lines, badges-heavy, navigation-heavy) made by release-cli.yml at publish time. That format is tuned for GitHub visitors landing on the project, not for Rust devs evaluating the crate from a crates.io search. This commit ships a dedicated cli/README.md tailored to the crates.io audience: tagline, what-it-is paragraph, install (cargo install + prebuilt binaries for 4 platforms), 5-line quickstart, six bullets of core capabilities, multi-CLI agent support note with the AGENTS.md context, features table, and links back to the full docs on GitHub. Length: ~110 lines. Workflow change: removes the `cp README.md cli/README.md` step from release-cli.yml so cargo publish uses the file shipped in the repo instead of overwriting it with the root README at CI time. cargo package --list confirms the new README is included in the .crate artifact. No behavior change to the CLI binary; this affects only what crates.io renders on the package page for cli-3.13.2 and later.
1 parent d05cdd8 commit c243eed

35 files changed

Lines changed: 358 additions & 83 deletions

.github/workflows/release-cli.yml

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -181,9 +181,6 @@ jobs:
181181
- name: Install Rust toolchain
182182
uses: dtolnay/rust-toolchain@stable
183183

184-
- name: Copy README into crate directory
185-
run: cp README.md cli/README.md
186-
187184
- name: Publish to crates.io
188185
env:
189186
CARGO_REGISTRY_TOKEN: ${{ secrets.CRATES_IO_TOKEN }}

CHANGELOG.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,39 @@ and this project uses [independent versioning](README.md#versioning) for Framewo
77

88
---
99

10+
## Framework 4.15.0 / CLI 3.13.2 — AGENTS.md universal injection
11+
12+
Adds `AGENTS.md` as a first-class injection target. `AGENTS.md` is the open standard for AI coding agents, donated to the Agentic AI Foundation (Linux Foundation, 2025) and read by Claude Code, OpenAI Codex CLI, Cursor, Aider, Devin, Sourcegraph Amp, Google Jules, Zed AI, Continue, Roo Code, Factory Droids, GitHub Copilot, Gemini CLI, Windsurf, Amazon Q and others. Before this release, StrayMark injected directives only into platform-specific files (`CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.cursorrules`, `.cursor/rules/straymark.md`); adopters using any of the 15+ CLIs that read `AGENTS.md` instead had to copy directives by hand. From `fw-4.15.0`, `straymark init` and `straymark update-framework` keep `AGENTS.md` in sync with `STRAYMARK.md` automatically.
13+
14+
### Added (Framework)
15+
16+
- **`dist/dist-templates/directives/AGENTS.md`** — new template (reference shape, parallel to `CLAUDE.md` / `GEMINI.md`). Marker block points to `STRAYMARK.md`; below the markers, a "minimum viable" body declares identity, review requirements, pre-commit checklist, regulatory frontmatter snippet, NIST AI 600-1 risk categories, observability rules, and the naming convention — sufficient for any reader that cannot follow the relative link.
17+
- **`dist/dist-manifest.yml` `injections:`** — new entry `target: AGENTS.md` (reference shape, no embed). Placed first in the list to mark it as the universal entry point.
18+
- **`STRAYMARK.md` § Directive Injection Markers** — explicit mention of `AGENTS.md` with the standard's context (Agentic AI Foundation donation, reader list) and the coexistence rule (CLI-specific files coexist with `AGENTS.md` for platform-specific identity strings).
19+
- **`cli/tests/inject_test.rs`** — three new integration tests:
20+
- `test_agents_md_template_has_markers` — verifies the shipped template has the right marker shape and pointer.
21+
- `test_manifest_declares_agents_md_injection` — verifies the manifest declares the injection so init/update/remove all pick it up.
22+
- `test_agents_md_coexists_with_preexisting_file` — pins the append-when-no-markers behavior against the very common case of an adopter who already has an `AGENTS.md`.
23+
24+
### Added (CLI)
25+
26+
- **`AGENTS.md` in `LEGACY_DIRECTIVE_TARGETS`** (`cli/src/commands/remove.rs:13`) — the data-driven `clean_directives` path (which reads `.straymark/dist-manifest.yml`) already cleans `AGENTS.md` correctly for `fw-4.15.0` installations. This change extends the legacy fallback that fires when the local manifest is missing or fails to parse, so `straymark remove` cleans `AGENTS.md` defensively in that edge case rather than leaving it orphaned. Follows the existing convention of keeping `LEGACY_DIRECTIVE_TARGETS` in sync with the manifest's `injections:` list.
27+
28+
### Changed (Framework)
29+
30+
- **Governance footers** bumped to `v4.15.0` across `QUICK-REFERENCE.md`, `AGENT-RULES.md`, `DOCUMENTATION-POLICY.md`, `C4-DIAGRAM-GUIDE.md`, `FOLLOW-UPS-BACKLOG-PATTERN.md` (EN + ES + zh-CN, plus the top-level `dist/.straymark/QUICK-REFERENCE.md`).
31+
- **Version tables** in `README.md` (root + i18n) and `CLI-REFERENCE.md` (EN + ES + zh-CN) bumped to `fw-4.15.0`. Canonical-output examples follow.
32+
- **AI Agent Support sections** in `README.md`, `ADOPTION-GUIDE.md` and equivalent i18n files now list `AGENTS.md` as the universal entry point with the full reader-CLI inventory.
33+
- **`init` / `update` descriptions** in `CLI-REFERENCE.md` and `ADOPTION-GUIDE.md` (EN + ES + zh-CN) list `AGENTS.md` first among directive files.
34+
35+
### Adopter guidance
36+
37+
`straymark update-framework` brings the new template and injects `AGENTS.md` at the project root. The injection follows the same rules as every other directive target: it creates the file if absent, replaces the marker block on subsequent runs, and appends safely when the file pre-exists without StrayMark markers (very common in 2026 — many adopters already hand-maintain an `AGENTS.md`). `straymark update-cli` brings the matching `cli-3.13.2` binary so the `remove` legacy fallback also covers `AGENTS.md`; updating only the framework is safe because the common cleanup path is manifest-driven and already includes the new target.
38+
39+
If your `.gitignore` excludes `AGENTS.md`, adjust it before `update-framework` so the injection lands in version control.
40+
41+
---
42+
1043
## Framework 4.14.3 — Spec-refresh discipline for multi-Charter execution (closes #150 Asks 1, 2, 4)
1144

1245
Framework-only patch that closes a governance gap reported by Sentinel after running a single `specs/002-commshub/plan.md` through **seven consecutive Charters** over ~1 month. The bridge doc (`SPECKIT-CHARTER-BRIDGE.md`) covered Charter *declaration* but said nothing about *spec maintenance during multi-Charter execution* — and naively re-running `/speckit-plan` regenerates assertions about already-shipped user stories that the actual code does not implement, propagating stale state into future audits.

README.md

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ The full document, with empirical annotations from validation cycles, lives in [
9999
Sixteen document types covering the full development lifecycle (twelve core + four China-specific opt-in):
100100

101101
| Type | Purpose | Example |
102-
|------|---------|---------|
102+
| --- | --- | --- |
103103
| **REQ** | Requirements | System requirements, user stories |
104104
| **ADR** | Architecture Decisions | Technology choices, design patterns |
105105
| **TES** | Test Plans | Test strategies, coverage goals |
@@ -123,6 +123,7 @@ Sixteen document types covering the full development lifecycle (twelve core + fo
123123

124124
Pre-configured for popular AI coding assistants:
125125

126+
- **Universal (AGENTS.md standard)**`AGENTS.md` — read by Claude Code, OpenAI Codex CLI, Cursor, Aider, Devin, Sourcegraph Amp, Google Jules, Zed AI, Continue, Roo Code, Factory Droids, GitHub Copilot, Gemini CLI, Windsurf, Amazon Q and others
126127
- **Claude Code** (Anthropic) → `CLAUDE.md`
127128
- **Cursor**`.cursorrules`
128129
- **GitHub Copilot CLI**`.github/copilot-instructions.md`
@@ -180,7 +181,7 @@ The discipline StrayMark externalizes — explicit scope, declared decisions, na
180181
### Standards Alignment
181182

182183
| Standard | StrayMark Integration |
183-
|----------|---------------------|
184+
| --- | --- |
184185
| **ISO/IEC 42001:2023** | Vertebral standard — AI Management System governance |
185186
| **EU AI Act** | Risk classification, incident reporting, transparency |
186187
| **NIST AI RMF / 600-1** | 12 GenAI risk categories in ETH/AILOG |
@@ -193,7 +194,7 @@ The discipline StrayMark externalizes — explicit scope, declared decisions, na
193194
### China Regulatory Coverage — opt-in via `regional_scope: china`
194195

195196
| Standard | StrayMark Integration |
196-
|----------|---------------------|
197+
| --- | --- |
197198
| **TC260 AI Safety Governance Framework v2.0** | Five-level risk grading (TC260RA) |
198199
| **PIPL — Personal Information Protection Law** | Personal Information Protection Impact Assessment (PIPIA), retention ≥ 3 years |
199200
| **GB 45438-2025** *(mandatory)* | AI-generated content labeling — explicit + implicit (AILABEL) |
@@ -274,16 +275,16 @@ The CLI downloads the latest StrayMark release, sets up the framework, and confi
274275
StrayMark uses independent version tags for each component:
275276

276277
| Component | Tag prefix | Example | Includes |
277-
|-----------|-----------|---------|----------|
278-
| Framework | `fw-` | `fw-4.14.3` | Templates (12 types), governance, directives, Charter template + schema |
279-
| CLI | `cli-` | `cli-3.13.1` | The `straymark` binary |
278+
| --- | --- | --- | --- |
279+
| Framework | `fw-` | `fw-4.15.0` | Templates (12 types), governance, directives, Charter template + schema |
280+
| CLI | `cli-` | `cli-3.13.2` | The `straymark` binary |
280281

281282
Check installed versions with `straymark status` or `straymark about`.
282283

283284
### CLI Commands
284285

285286
| Command | Description |
286-
|---------|-------------|
287+
| --- | --- |
287288
| `straymark init [path]` | Initialize StrayMark in a project |
288289
| `straymark update` | Update both framework and CLI |
289290
| `straymark update-framework` | Update only the framework |
@@ -308,7 +309,7 @@ See [CLI Reference](https://github.com/StrangeDaysTech/straymark/blob/main/docs/
308309
```bash
309310
# Download the latest framework release ZIP from GitHub
310311
# Go to https://github.com/StrangeDaysTech/straymark/releases
311-
# and download the latest fw-* release (e.g., fw-4.14.3)
312+
# and download the latest fw-* release (e.g., fw-4.15.0)
312313
313314
# Extract and copy to your project
314315
unzip straymark-fw-*.zip -d your-project/
@@ -328,7 +329,7 @@ git commit -m "chore: adopt StrayMark"
328329
StrayMark documentation is organized by audience:
329330

330331
| Track | For | Start here |
331-
|-------|-----|------------|
332+
| --- | --- | --- |
332333
| [**Adopters**](https://github.com/StrangeDaysTech/straymark/tree/main/docs/adopters) | Teams adopting StrayMark in their projects | [ADOPTION-GUIDE.md](https://github.com/StrangeDaysTech/straymark/blob/main/docs/adopters/ADOPTION-GUIDE.md) |
333334
| [**Contributors**](https://github.com/StrangeDaysTech/straymark/tree/main/docs/contributors) | Developers contributing to StrayMark | [TRANSLATION-GUIDE.md](https://github.com/StrangeDaysTech/straymark/blob/main/docs/contributors/TRANSLATION-GUIDE.md) |
334335

@@ -339,7 +340,7 @@ StrayMark documentation is organized by audience:
339340
### Key References
340341

341342
| Document | Description |
342-
|----------|-------------|
343+
| --- | --- |
343344
| [**Quick Reference**](https://github.com/StrangeDaysTech/straymark/blob/main/dist/.straymark/QUICK-REFERENCE.md) | One-page overview of document types and naming |
344345
| [STRAYMARK.md](https://github.com/StrangeDaysTech/straymark/blob/main/dist/STRAYMARK.md) | Unified governance rules (source of truth) |
345346
| [ADOPTION-GUIDE.md](https://github.com/StrangeDaysTech/straymark/blob/main/docs/adopters/ADOPTION-GUIDE.md) | Adoption guide for new/existing projects |
@@ -486,7 +487,7 @@ StrayMark includes skills for AI agents that enable **active documentation creat
486487
### Available Skills
487488

488489
| Skill | Purpose | Claude | Gemini |
489-
|-------|---------|--------|--------|
490+
| --- | --- | --- | --- |
490491
| `/straymark-status` | Check documentation compliance |||
491492
| `/straymark-new` | Create any document type (unified) |||
492493
| `/straymark-ailog` | Quick AILOG creation |||
@@ -533,7 +534,7 @@ straymark status
533534
AI agents report documentation status at the end of each task:
534535

535536
| Status | Meaning |
536-
|--------|---------|
537+
| --- | --- |
537538
| `StrayMark: Created AILOG-...` | Documentation was created |
538539
| `StrayMark: No documentation required` | Change was minor |
539540
| `StrayMark: Documentation pending` | May need manual review |
@@ -557,7 +558,7 @@ your-project/
557558
```
558559

559560
| Directory | Agent | Product | Format |
560-
|-----------|-------|---------|--------|
561+
| --- | --- | --- | --- |
561562
| `.agent/workflows/` | Antigravity, generic | VS Code/Cursor extensions | `skill-name.md` with YAML frontmatter |
562563
| `.gemini/skills/` | Gemini CLI | Google's terminal CLI | `skill-name/SKILL.md` |
563564
| `.claude/skills/` | Claude Code | Anthropic's coding agent | `skill-name/SKILL.md` |
@@ -573,7 +574,8 @@ All skill implementations are **functionally identical**—only the format diffe
573574
### AI Coding Assistants
574575

575576
| Platform | Config File | Status |
576-
|----------|-------------|--------|
577+
| --- | --- | --- |
578+
| Universal (AGENTS.md standard) | `AGENTS.md` | ✅ Full support |
577579
| Claude Code | `CLAUDE.md` | ✅ Full support |
578580
| Cursor | `.cursorrules` | ✅ Full support |
579581
| GitHub Copilot CLI | `.github/copilot-instructions.md` | ✅ Full support |
@@ -582,15 +584,15 @@ All skill implementations are **functionally identical**—only the format diffe
582584
### Operating Systems
583585

584586
| OS | Validation |
585-
|----|------------|
587+
| --- | --- |
586588
| Linux | `straymark validate` |
587589
| macOS | `straymark validate` |
588590
| Windows | `straymark validate` |
589591

590592
### CI/CD Platforms
591593

592594
| Platform | Support |
593-
|----------|---------|
595+
| --- | --- |
594596
| GitHub Actions | ✅ Included workflow |
595597
| GitLab CI | 🔧 Adaptable from GitHub Actions |
596598
| Azure DevOps | 🔧 Adaptable from GitHub Actions |
@@ -623,14 +625,14 @@ This project is licensed under the MIT License - see the [LICENSE](https://githu
623625

624626
<div align="center">
625627

626-
**[Strange Days Tech](https://strangedays.tech)** builds tools for responsible AI-assisted software development.
628+
[**Strange Days Tech**](https://strangedays.tech) builds tools for responsible AI-assisted software development.
627629

628630
Our open-source ecosystem:
629631

630632
| Project | Description |
631-
|---------|-------------|
632-
| **[StrayMark](https://github.com/StrangeDaysTech/straymark)** | The cognitive discipline your AI-assisted projects need |
633-
| **[arborist-metrics](https://github.com/StrangeDaysTech/arborist)** | Multi-language code complexity analysis library for Rust — [crates.io](https://crates.io/crates/arborist-metrics) |
633+
| --- | --- |
634+
| [**StrayMark**](https://github.com/StrangeDaysTech/straymark) | The cognitive discipline your AI-assisted projects need |
635+
| [**arborist-metrics**](https://github.com/StrangeDaysTech/arborist) | Multi-language code complexity analysis library for Rust — [crates.io](https://crates.io/crates/arborist-metrics) |
634636

635637
[Website](https://strangedays.tech)[GitHub](https://github.com/StrangeDaysTech)
636638

cli/Cargo.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

cli/Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "straymark-cli"
3-
version = "3.13.1"
3+
version = "3.13.2"
44
edition = "2021"
55
description = "CLI for StrayMark — the cognitive discipline your AI-assisted projects need"
66
license = "MIT"

cli/README.md

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
# straymark-cli
2+
3+
> **The cognitive discipline your AI-assisted projects need.**
4+
5+
[![Crates.io](https://img.shields.io/crates/v/straymark-cli.svg)](https://crates.io/crates/straymark-cli)
6+
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/StrangeDaysTech/straymark/blob/main/LICENSE)
7+
[![Handbook](https://img.shields.io/badge/docs-Handbook-orange.svg)](https://github.com/StrangeDaysTech/straymark/blob/main/dist/.straymark/QUICK-REFERENCE.md)
8+
9+
StrayMark externalizes the cognitive discipline of senior software engineering — explicit scope, declared decisions, named risks, recorded alternatives, audited trails — into versioned files that live alongside the code, and injects the same discipline into the AI agents that work in the repo. This crate provides the `straymark` CLI that manages the framework, validates documents, runs drift checks against Charter scope, and orchestrates external multi-CLI audits. As a side effect, the artifacts produced map cleanly onto **ISO/IEC 42001**, **EU AI Act**, **NIST AI RMF**, **GDPR** and (opt-in) the Chinese AI/data regulatory stack.
10+
11+
The goal is engineering quality first; compliance is what falls out when the discipline is real.
12+
13+
## Installation
14+
15+
### Via Cargo
16+
17+
```bash
18+
cargo install straymark-cli
19+
```
20+
21+
### Prebuilt binaries
22+
23+
Download the binary for your platform from the [latest release](https://github.com/StrangeDaysTech/straymark/releases/latest):
24+
25+
- **Linux (x86_64)**`straymark-cli-v<version>-x86_64-unknown-linux-gnu.tar.gz`
26+
- **macOS Intel**`straymark-cli-v<version>-x86_64-apple-darwin.tar.gz`
27+
- **macOS Apple Silicon**`straymark-cli-v<version>-aarch64-apple-darwin.tar.gz`
28+
- **Windows**`straymark-cli-v<version>-x86_64-pc-windows-msvc.zip`
29+
30+
Extract and place the `straymark` binary somewhere on your `PATH`.
31+
32+
### Upgrade
33+
34+
If you already have an older version installed:
35+
36+
```bash
37+
straymark update-cli # self-update the binary
38+
straymark update-framework # update the framework in a project
39+
straymark update # both at once
40+
```
41+
42+
## Quickstart
43+
44+
Inside a Git repository:
45+
46+
```bash
47+
straymark init . # install the framework into the project
48+
straymark charter new # scaffold a bounded unit of work (ex-ante scope)
49+
straymark validate # validate documents against schemas
50+
straymark audit # generate the project audit report
51+
straymark explore # interactive TUI to browse documentation
52+
```
53+
54+
The full subcommand reference (`init`, `update`, `remove`, `status`, `repair`, `validate`, `new`, `compliance`, `metrics`, `analyze`, `audit`, `explore`, `charter`, `about`) lives in the [CLI Reference](https://github.com/StrangeDaysTech/straymark/blob/main/docs/adopters/CLI-REFERENCE.md).
55+
56+
## What StrayMark does
57+
58+
- **Versioned governance artifacts** — 12 base document types (`AILOG`, `AIDEC`, `ETH`, `ADR`, `REQ`, `TES`, `INC`, `TDE`, `SEC`, `MCARD`, `SBOM`, `DPIA`) + 4 China-scope types + the `Charter` unit of work, each with schemas and lifecycle.
59+
- **Multi-CLI agent directives injected** — keeps `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.cursorrules` and `.cursor/rules/straymark.md` in sync from a single `STRAYMARK.md` source of truth.
60+
- **Charter drift check** — verifies declared files against `git diff` so the implementation cannot silently diverge from the ex-ante scope.
61+
- **External multi-CLI audit orchestration** — generates unified audit prompts and consolidates reports from multiple auditor CLIs into Charter telemetry.
62+
- **Multi-regulatory mapping** — output artifacts satisfy ISO/IEC 42001, EU AI Act, NIST AI RMF, ISO/IEC 25010, ISO/IEC/IEEE 29148, ISO/IEC/IEEE 29119-3, GDPR.
63+
- **Optional China regulatory scope** — opt-in via `regional_scope: china` activates PIPIA, CACFILE, TC260RA and AILABEL document types plus PIPL / TC260 / GB 45438 / CAC / GB/T 45652 / CSL 2026 mapping.
64+
65+
## Multi-CLI agent support
66+
67+
The CLI reads (and writes injection markers into) the dominant standards for AI coding agents:
68+
69+
- **`AGENTS.md`** — the open standard donated to the Agentic AI Foundation (Linux Foundation, December 2025), read by Claude Code, OpenAI Codex CLI, Cursor, Aider, Devin, Sourcegraph Amp, Google Jules, Zed AI, Continue, Roo Code, Factory Droids, GitHub Copilot, Gemini CLI, Windsurf, Amazon Q and others.
70+
- **CLI-specific files**`CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.cursorrules`, `.cursor/rules/straymark.md` for platform-specific identity strings.
71+
72+
All targets stay synchronized from a single `STRAYMARK.md` file maintained by `straymark update`.
73+
74+
## Features
75+
76+
| Feature | Default | Description |
77+
|---------|---------|-------------|
78+
| `tui` | yes | Interactive `explore` TUI (ratatui + crossterm + pulldown-cmark) |
79+
| `analyze` | yes | Code complexity analysis (cognitive + cyclomatic via arborist-metrics) |
80+
81+
Build without TUI:
82+
83+
```bash
84+
cargo install straymark-cli --no-default-features --features analyze
85+
```
86+
87+
## Documentation
88+
89+
- **Project README**https://github.com/StrangeDaysTech/straymark
90+
- **Handbook**https://github.com/StrangeDaysTech/straymark/blob/main/dist/.straymark/QUICK-REFERENCE.md
91+
- **CLI Reference**https://github.com/StrangeDaysTech/straymark/blob/main/docs/adopters/CLI-REFERENCE.md
92+
- **Adoption Guide**https://github.com/StrangeDaysTech/straymark/blob/main/docs/adopters/ADOPTION-GUIDE.md
93+
- **Changelog**https://github.com/StrangeDaysTech/straymark/blob/main/CHANGELOG.md
94+
- **Español**https://github.com/StrangeDaysTech/straymark/blob/main/docs/i18n/es/README.md
95+
- **简体中文**https://github.com/StrangeDaysTech/straymark/blob/main/docs/i18n/zh-CN/README.md
96+
97+
## License
98+
99+
MIT — © Strange Days Tech, S.A.S.
100+
101+
## See also
102+
103+
The framework that ships alongside this CLI lives in the same repository: [`StrangeDaysTech/straymark`](https://github.com/StrangeDaysTech/straymark). Framework releases are tagged `fw-X.Y.Z`; CLI releases are tagged `cli-X.Y.Z` and published here on crates.io.
104+
105+
---
106+
107+
*[Strange Days Tech](https://strangedays.tech) — Because every change tells a story.*

0 commit comments

Comments
 (0)