This pull request introduces several enhancements and new features to the agentic-check tool, focusing on improved folder specialization, preview mode for installing directives and skills from source repo branches, and better user guidance. It also includes some codebase improvements and new utility classes. The most important changes are summarized below:
New Features and Command-Line Options
- Added a
--previewoption to enable installing preview directives and skills from source repository default branches, allowing users to try out unreleased or in-development features. [1] [2] [3] [4] [5] [6] [7]
Folder Specialization Support and Documentation
- Improved support for folder specialization, enabling users to compose a specialization hierarchy for folders in their repo (e.g., common directives in the root, specialized ones in subfolders). Updated the README and CLI help text to document this workflow. [1] [2]
User Experience and Guidance
- Enhanced user guidance when prerequisites are missing by providing a direct link and prompt to install the GitHub CLI if it is not detected or is outdated.
Codebase Improvements
- Changed the
--skills-diroption to accept only target-contained relative paths, improving security and clarity. Updated validation logic accordingly. [1] [2] - Added new utility classes:
ActionOutputFormatterfor consistent CLI output formatting, andBrowserLauncherfor opening URLs in the default browser across platforms. [1] [2]
Other Changes
- Bumped the tool version to
2.2.0and updated package release notes to reference the GitHub releases page. [1] [2] - Extended several internal APIs and data structures to support the new features, including passing the new
previewflag throughout the workflow and updating skill installation logic. [1] [2] [3] [4] [5]
These changes collectively make the tool more flexible for real-world monorepos, safer to use, and easier for users to adopt new features or resolve setup issues.