Skip to content

More flexible artifacts - #37

Merged
mrsimpson merged 3 commits into
mainfrom
more-flexible-artifacts
Aug 12, 2025
Merged

mrsimpson merged 3 commits into
mainfrom
more-flexible-artifacts

Conversation

@mrsimpson

Copy link
Copy Markdown
Collaborator

No description provided.

- Enhanced setup_project_docs tool to accept file paths in addition to template names
- Added support for linking existing documentation files (README.md, ARCHITECTURE.md, etc.)
- Implemented symlink creation in .vibe/docs/ folder for standard path integration
- Added PathValidationUtils class for secure file path validation
- Added FileDetectionManager class for pattern-based file discovery
- Enhanced ProjectDocsManager with symlink creation and management
- Updated tool descriptions with comprehensive examples and usage guidance
- Added comprehensive integration tests (215 tests passing)
- Supports mixed usage: combine templates and file paths in same setup call
- Multiple document types can reference the same source file
- Maintains full backward compatibility with existing template workflows

BREAKING CHANGE: setup_project_docs tool parameters now accept string values instead of strict enums, but existing template names continue to work unchanged
- Added 'none' template option for architecture, requirements, and design documents
- Creates instructional placeholder documents that guide LLM to use plan file instead
- Enables granular control: users can disable specific document types while keeping others
- Cross-conversation persistence: choice survives across sessions
- Clear LLM instructions with 'DO NOT EDIT THIS FILE' guidance
- Enhanced tool descriptions with 'none' option examples and usage guidance
- Added comprehensive test coverage for 'none' template functionality (221 tests passing)
- Perfect for users who prefer plan-file-only workflows or minimal documentation overhead

Example usage:
setup_project_docs({
  architecture: 'arc42',      // Use template
  requirements: 'none',       // Disable with placeholder
  design: 'README.md'         // Link existing file
})
@mrsimpson
mrsimpson merged commit 27cdd72 into main Aug 12, 2025
3 checks passed
@mrsimpson
mrsimpson deleted the more-flexible-artifacts branch August 13, 2025 09:54
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.

1 participant