Skip to content

refactor: consolidate distribution files under dist/ and update docs#2

Merged
montfort merged 5 commits intomainfrom
docs/update-contributing-cla-setup
Mar 2, 2026
Merged

refactor: consolidate distribution files under dist/ and update docs#2
montfort merged 5 commits intomainfrom
docs/update-contributing-cla-setup

Conversation

@montfort
Copy link
Copy Markdown
Contributor

@montfort montfort commented Mar 2, 2026

Summary

  • docs: Update CONTRIBUTING guides (EN/ES) with CLA section and revised dev setup paths
  • refactor: Separate dev directive files from distribution templates; CLI reads injection templates from files instead of hardcoded strings
  • chore: Remove root directive files (CLAUDE.md, GEMINI.md, .cursorrules, .cursor/) superseded by dist-templates/
  • refactor: Consolidate all distribution content under dist/ so the repo root stays clean for contributor dev configs

Motivation

Distribution files (.devtrail/, scripts/, agent skills, dist-templates) were scattered across root directories that overlap with AI tool config dirs (.claude/, .gemini/, .agent/). This caused conflicts for contributors who want their own local AI configs. Moving everything distributable under dist/ cleanly separates "what ships in the ZIP" from "repo development infrastructure."

Changes

  • git mv all distributable content under dist/ (.devtrail, DEVTRAIL.md, dist-manifest.yml, dist-templates, agent skills, scripts, docs-validation workflow)
  • Simplify release.yml ZIP staging from ~25 lines of selective copies to a single cp -a dist/.
  • Add root-anchored .gitignore rules for /.claude/, /.gemini/, /.agent/, /.cursorrules, /.cursor/
  • CLI inject.rs reads directive templates from files in dist-templates/ instead of hardcoded strings
  • dist-manifest.yml updated with inject_directives entries and embed_file support
  • Update all internal doc links in README.md, CONTRIBUTING.md, docs/README.md, and their ES translations
  • Remove obsolete root directive files no longer needed after dist-templates refactor

Test plan

  • cargo test --manifest-path cli/Cargo.toml — all 20 tests pass
  • git status dist/.claude/ — gitignore does not block dist/ subdirs
  • Simulated ZIP staging with cp -a dist/. /tmp/stg/ — structure matches expected output
  • Verified all markdown link targets exist

🤖 Generated with Claude Code

montfort and others added 5 commits March 2, 2026 10:01
Replace inline Code of Conduct standards with a summary linking to
CODE_OF_CONDUCT.md, add CLA Assistant requirement section, fix dev
setup commands (correct cd path, add pre-commit hook step, add Rust
toolchain prerequisite), and sync Spanish translation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Root directive files (CLAUDE.md, GEMINI.md, .cursorrules,
copilot-instructions.md) now serve dev-only purposes, with clean
distribution templates moved to dist-templates/directives/. Updates
release workflow to source copilot-instructions.md from the new
location and removes the redundant file entry from dist-manifest.yml.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ed strings

Replace hardcoded injection content in the CLI with a template-driven
approach. The manifest now declares each injection as {target, template,
embed?} and the CLI reads actual template files from the distribution ZIP.

- Add cursorrules and cursor-rules-devtrail.md templates with empty markers
- Restructure dist-manifest.yml injections from object to list format
- New unified `inject_directive()` replaces three separate inject functions
- init.rs reads templates from ZIP into memory, iterates manifest.injections
- update.rs reads templates from extracted source, only updates existing targets
- remove.rs loads local manifest for cleanup with legacy fallback
- Save dist-manifest.yml locally in .devtrail/ for remove operations
- Include dist-templates/ directory in release ZIP
- Update unit tests (11) and integration tests (4)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
These files were only serving as distribution examples and contained no
project-specific development directives. The canonical templates now
live in dist-templates/directives/ and are read by the CLI at runtime.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Move .devtrail/, DEVTRAIL.md, dist-manifest.yml, dist-templates/,
agent skills (.claude/skills, .gemini/skills, .agent/workflows),
scripts/, and docs-validation.yml under dist/ so the repo root
stays clean for contributor dev configs. Simplify release workflow
to a single `cp -a dist/.` and add root-anchored gitignore rules
for AI tool directories. Update all internal doc links accordingly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Mar 2, 2026

CLA assistant check
All committers have signed the CLA.

@montfort montfort changed the title docs: update CONTRIBUTING guides with CLA section and revised dev setup refactor: consolidate distribution files under dist/ and update docs Mar 2, 2026
@montfort montfort merged commit 63d2653 into main Mar 2, 2026
1 check was pending
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants