Skip to content

Comments

Refactor and update docs#64

Merged
alex-feel merged 9 commits intomainfrom
alex-feel-dev
Sep 5, 2025
Merged

Refactor and update docs#64
alex-feel merged 9 commits intomainfrom
alex-feel-dev

Conversation

@alex-feel
Copy link
Owner

No description provided.

Refactor project structure to better reflect that these are production-ready
resources, not demo examples. All 'examples/' directories have been renamed
to 'library/' to indicate these are curated, ready-to-use components.

Updates include:
- Rename all examples/ directories to library/ across all component types
- Update setup_environment.py to load from library/ instead of examples/
- Update template references to use library/ paths
Simplify documentation to be more maintainable by removing:
- Specific entity counts that become outdated
- Detailed listings of library components
- References to 'examples' terminology

This makes documentation maintenance easier as components are added or
removed without requiring README updates each time.
Update GitHub Actions workflow to:
- Only trigger on pull requests (no push to main)
- Validate environment configurations in library/ directory
- Allow templates to fail validation (expected behavior)
- Create Python script to count all library components
- Generate shields.io-compatible JSON badge data
- Validate YAML configurations during counting
- Support environments, agents, commands, prompts, styles, and hooks
- Run on push to main when library components change
- Execute entity counting script with Python 3.12
- Generate fresh badge data on each update
- Support manual workflow dispatch for on-demand updates
- Display real-time counts for all component types
- Use shields.io dynamic badges with JSON data source
- Color-code badges by component type for visual clarity
- Show total component count prominently
The workflow was failing with 403 errors when trying to comment on pull requests because the default GITHUB_TOKEN didn't have explicit write permissions for pull requests.
@github-actions
Copy link

github-actions bot commented Sep 5, 2025

✅ Configuration Validation Passed

All environment configuration files have been validated successfully.

@alex-feel alex-feel merged commit 61eb2f1 into main Sep 5, 2025
6 checks passed
@alex-feel alex-feel deleted the alex-feel-dev branch September 5, 2025 21:55
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