Skip to content

Chore: Organize poc-opencode-server into logical directory structure - #1009

Merged
tbrandenburg merged 1 commit into
mainfrom
chore/organize-poc-opencode-server
Feb 2, 2026
Merged

Chore: Organize poc-opencode-server into logical directory structure#1009
tbrandenburg merged 1 commit into
mainfrom
chore/organize-poc-opencode-server

Conversation

@tbrandenburg

Copy link
Copy Markdown
Owner

Problem

The dev/poc-opencode-server/ directory contained 33+ files in a flat structure, making it difficult to navigate and understand the organization of planning documents, guides, demos, scripts, and results.

Solution

Reorganized all files into a logical 6-directory structure:

  • 00-planning/ - Research and planning documents (POC_NOTES, FINDINGS, WORK-CLI-INTEGRATION)
  • 01-guides/ - Step-by-step user guides (QUICKSTART, APPLICATION_GUIDE, SDK-EVALUATION, etc.)
  • 02-reference/ - Technical reference documentation (INDEX, SUMMARY, AGENTS-MODELS-PERMISSIONS)
  • 03-demos/ - Working code examples (11 demo files)
  • 04-scripts/ - Automation scripts (explore.sh, VERIFY.sh)
  • 05-results/ - Test results and logs

Changes

  • Created 6 numbered directories for logical grouping
  • Moved all 33 files into appropriate directories
  • Added .gitignore to exclude node_modules/ from version control
  • Updated README.md with new structure overview and navigation links
  • Updated MANIFEST.md with complete file organization reference
  • Enhanced package.json with npm scripts reflecting new paths:
    • npm run demo - Main ACP demo
    • npm run demo:sdk - SDK testing
    • npm run demo:resume - Session resumption
    • npm run verify - Environment verification

Testing

✅ All 303 unit tests passed
✅ Directory structure verified with tree command
✅ File organization confirmed via git status

Example Structure

dev/poc-opencode-server/
├── 00-planning/          # Research docs
├── 01-guides/            # User guides  
├── 02-reference/         # API reference
├── 03-demos/             # Working code (11 files)
├── 04-scripts/           # Automation
├── 05-results/           # Test results & logs
├── README.md             # Updated with navigation
├── MANIFEST.md           # Complete file index
└── package.json          # npm scripts

Notes

  • Root .gitignore still excludes entire dev/ directory (as per project guidelines)
  • This PR force-adds the organized PoC files for preservation
  • PoC is frozen as of 2026-02-02 for historical reference
  • All working demos and documentation preserved in organized structure

- Reorganize files into 6 directories (00-planning through 05-results)
- Add local .gitignore to exclude node_modules
- Update README with clear navigation and file structure
- Update MANIFEST with new organization
- Update package.json scripts to reflect new paths
- Preserve all PoC documentation and working code
- Keep dev/ in root .gitignore per project guidelines
@tbrandenburg
tbrandenburg merged commit c640273 into main Feb 2, 2026
4 checks passed
@tbrandenburg
tbrandenburg deleted the chore/organize-poc-opencode-server branch February 2, 2026 17:15
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