Conversation
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>
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
1 participant
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
Propuesta/devtrail-design-principles.md. Removes internal-language phrases that confuse readers unfamiliar with Sentinel (the project that produced the empirical evidence).Scope
Generalized in 5 sections of the file:
Removed all references to specific Sentinel artifacts (AILOG-020, AILOG-022, PLAN-05.telemetry.yaml, etc.); replaced with abstracted descriptions ("un drift-check ejecutado al cierre del trabajo", "una plantilla rígida que choca con la convención del módulo destino"). Sentinel is named once with context ("un sistema Go backend") on first mention and once in the version metadata.
Version bumped 0.2.1 → 0.2.2 (editorial polish, no semantic change).
Test plan
AILOG-[0-9],PLAN-[0-9],/plan-audit,Copilot,Geminiin the file (confirmed locally).🤖 Generated with Claude Code