database-design

agents-exploration-20260523

This repo is a learning experiment by Steven Li based on wshobson/agents.

It is not affiliated with the original project. It records one day's experiment with the codebase.

What's different from upstream

• Added tools/validate_agent_unique_names.py (+98 lines). Scans all .md files under plugins/, extracts the name field from YAML frontmatter with a lightweight regex-based parser, and reports any name that appears in more than one file. Exits with code 1 if duplicates exist, otherwise 0.
• Added tools/tests/test_validate_agent_unique_names.py (+121 lines). Five unit tests covering:
  • parsing valid frontmatter
  • files without frontmatter (not parsed)
  • directory traversal that excludes non-agent files
  • duplicate detection (two files with the same name in subdirectories)
  • clean run when all names are unique
• No changes to existing plugin files, agent markdown, or CI workflows. The new tool is a standalone validation script that can be run manually or added to CI later.

Total: 2 new files, ~219 lines added, 0 lines removed.

Status

This repo is not maintained. Issues filed here will not be addressed. If you want the maintained version of the project, use the upstream repo.

If something here is useful, port it upstream yourself or open an issue on the upstream repo with a link to this work.

The original project workflow files are stored in UPSTREAM_WORKFLOWS_DISABLED/ for reference. They are not active in this snapshot.

License

The original LICENSE file is preserved verbatim in this repository.

Upstream attribution

Original project: wshobson/agents Upstream commit at fork time: cbcde3f1f4309f023095181d3e591f983ec7c95d