docs: restructure documentation, add CLI reference and workflows#4
Merged
docs: restructure documentation, add CLI reference and workflows#4
Conversation
Decouple framework and CLI release cycles so each component can evolve independently. Framework uses `fw-*` tags, CLI uses `cli-*` tags, with separate GitHub Actions workflows for each. - Reset CLI version to 1.0.0, bump framework manifest to 2.1.0 - Add `get_latest_release_by_prefix()` to filter releases by tag prefix - Add `strip_tag_prefix()` helper for fw-/cli-/v- prefixes - Rename `update` command to `update-framework`, create combined `update` - Add `update-framework` subcommand to CLI router - Show both framework and CLI versions in `status` and `about` - Split release.yml into release-framework.yml and release-cli.yml - Update install scripts to fetch `cli-*` releases Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…rsion fixes Add CLI-REFERENCE.md and WORKFLOWS.md for adopters (EN + ES), update all docs to reflect independent fw-*/cli-* versioning, fix broken cookbook.md link, remove hardcoded v2.0.0 from dist files, and update releases/latest references to point to fw-* releases. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
|
montfort
added a commit
that referenced
this pull request
May 2, 2026
Editorial-only pass on Propuesta/devtrail-design-principles.md to remove internal-language phrases that confuse readers who don't know Sentinel (the project that produced the empirical evidence). All decisions and commitments preserved; only language generalized. Specific changes: - Version metadata now names the editorial pass and dates it. - v0.2 anotaciones intro: glosses Sentinel as "un sistema Go backend" on first mention, drops references to /plan-audit and PLAN-NN that cold readers can't anchor to anything. - Principle #6 anotación (virtud-vs-ceremonia): replaces specific artifact IDs (AILOG-020, AILOG-022, PLAN-05.telemetry.yaml) with abstracted descriptions of the empirical findings. The decisions about what counts as virtud vs ceremonia stay identical. - Principle #9 anotación (bash before framework): drops the script filename and AILOG ref, keeps the ~145-line metric and the three-property justification (zero-build, no deps, in-situ inspection). - Principle #12 anotación (N≥3 spirit): "Sentinel es un solo proyecto..." → "La evidencia empírica disponible proviene de un solo proyecto adoptante..."; specific scores (9.25/9.5) generalized to "scores similares"; supuesto #4 named as "supuesto de aprobaciones condicionales" instead of by number alone. - Meta-meta paragraph: drops Sentinel-specific framing while keeping the auto-evolución insight intact. Prerequisite for D4 of the README repositioning plan: link the design principles from the public README. Cold readers (a developer landing on GitHub, not someone who read all the propuesta docs) need to grasp each principle without first decoding internal artifacts. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
5 tasks
montfort
added a commit
that referenced
this pull request
May 2, 2026
Reframes DevTrail's canonical English surface from "AI Governance Platform" to engineering-discipline-first, with compliance positioned as a side effect. Aligns the README, DEVTRAIL.md, and DOCUMENTATION-POLICY.md with Principle #4 (compliance is a side effect, not the product) and Principle #2 (primary user is the senior engineer orchestrating agents). Spanish and zh-CN translations deferred to a follow-up i18n release. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
v2.0.0across 5 dist files and brokencookbook.mdlink in QUICK-REFERENCE.mdfw-*/cli-*versioning schemereleases/latestreferences to point users tofw-*tagged releasesupdate_framework.rs,status.rs)Test plan
v2.0.0in dist/ — 0 matchesreleases/latestacross repo — 0 matchescookbook.mdacross repo — 0 matches🤖 Generated with Claude Code