Skip to content

refactor: Archive old directories and consolidate templates (Phase 2)#10

Open
brian-lai wants to merge 4 commits into
mainfrom
para/unified-agents-md-phase-2
Open

refactor: Archive old directories and consolidate templates (Phase 2)#10
brian-lai wants to merge 4 commits into
mainfrom
para/unified-agents-md-phase-2

Conversation

@brian-lai

Copy link
Copy Markdown
Owner

Summary

Phase 2 of the unified AGENTS.md migration:

  • Archives old tool-specific directories to _archived/
  • Creates consolidated examples/ directory with practical templates
  • Updates internal documentation links
  • Adds deprecation notice for archived content

Changes

Archived Directories

Moved to _archived/ (will be removed in a future release):

Directory Replaced By
claude/ tool-setup/claude-code.md + AGENTS.md
cursor/ tool-setup/cursor.md + AGENTS.md
copilot/ tool-setup/copilot.md + AGENTS.md
codex/ tool-setup/codex.md + AGENTS.md
gemini/ tool-setup/community/others.md
other-ai-assistants/ tool-setup/community/

Note: claude-skill/ is NOT archived - it remains actively maintained.

New examples/ Directory

Consolidated, simplified templates:

examples/
├── README.md
├── plans/
│   ├── plan-template.md
│   └── example-add-authentication.md
├── summaries/
│   ├── summary-template.md
│   └── example-authentication-summary.md
└── workflows/
    └── context-template.md

Documentation Updates

  • AUTOMATED-SETUP.md - Links updated to point to tool-setup/ guides
  • _archived/README.md - Deprecation notice with migration info

Test plan

  • Verify archived directories are in _archived/
  • Verify examples/ templates are complete and usable
  • Check updated links work in AUTOMATED-SETUP.md
  • Confirm claude-skill/ is untouched

Phase 3 (Future PR)

  • Remove _archived/ directories entirely
  • Final cleanup and verification

🤖 Generated with Claude Code

brian-lai and others added 4 commits January 24, 2026 13:21
Starting Phase 2: Archive old directories and consolidate templates.
Phase 1 completed and merged in PR #9.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Moved to _archived/:
- claude/ (now use tool-setup/claude-code.md + AGENTS.md)
- cursor/ (now use tool-setup/cursor.md + AGENTS.md)
- copilot/ (now use tool-setup/copilot.md + AGENTS.md)
- codex/ (now use tool-setup/codex.md + AGENTS.md)
- gemini/ (now use tool-setup/community/others.md)
- other-ai-assistants/ (content consolidated into tool-setup/)

Kept:
- claude-skill/ (separate package, still maintained)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Created simplified, practical templates:
- examples/plans/plan-template.md - Minimal plan template
- examples/plans/example-add-authentication.md - Real-world example
- examples/summaries/summary-template.md - Minimal summary template
- examples/summaries/example-authentication-summary.md - Real-world example
- examples/workflows/context-template.md - context.md template
- examples/README.md - Usage guide

Templates are more concise than archived versions while remaining complete.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Updated AUTOMATED-SETUP.md links to point to tool-setup/ guides
- Added _archived/README.md with deprecation notice and migration info
- Explains what replaced each archived directory
- References MIGRATION.md for upgrade instructions

Co-Authored-By: Claude Opus 4.5 <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.

1 participant