Development Hub

Central orchestration project for managing Rob's multi-project development ecosystem.

Overview

Development Hub provides tooling to create and manage projects that follow consistent patterns:

• Centralized documentation via Docusaurus
• Gitea repository hosting with Pages support
• AI-assistant context files (CLAUDE.md)
• Python project structure

The new-project Script

The main tool is new-project, which automates creating a new project in the ecosystem:

new-project my-tool --title "My Tool" --tagline "Does useful things"

What It Creates

1. Gitea repository at gitea.brrd.tech/rob/my-tool
2. Local project at ~/PycharmProjects/my-tool/ with:
   • CLAUDE.md - AI assistant context
   • README.md - Project readme
   • pyproject.toml - Python packaging
   • .gitignore - Standard ignores
   • docs/ - Symlink to centralized docs
3. Documentation folder at project-docs/docs/projects/my-tool/
4. Build configuration in build-public-docs.sh

Usage

# Full specification
new-project myproject --title "My Project" --tagline "Short description"

# Interactive mode (prompts for title/tagline)
new-project myproject

# Options
--dry-run       Show what would happen without making changes
--skip-gitea    Skip Gitea repo creation (for offline use)
--help          Show help

Project Structure

development-hub/
├── bin/
│   └── new-project           # Main scaffolding script
├── templates/
│   ├── gitignore.template
│   ├── CLAUDE.md.template
│   ├── README.md.template
│   ├── pyproject.toml.template
│   ├── overview.md.template
│   └── updating-documentation.md.template
├── docs/                     # Symlink to this folder
├── CLAUDE.md
├── README.md
└── .gitignore

Configuration

Gitea API Token

The script needs a Gitea API token to create repositories automatically.

Setup options:

1. Environment variable: export GITEA_TOKEN=your_token
2. Config file: ~/.config/development-hub/gitea-token

The script will prompt for the token on first run and save it automatically.

Creating a token:

1. Go to https://gitea.brrd.tech/user/settings/applications
2. Generate a new token with 'repo' scope
3. Copy the token when prompted

Related Projects

Development Hub manages these projects:

Project	Description
CmdForge	AI-powered CLI tool builder
CascadingDev	Cascading Development Framework
Orchestrated Discussions	AI Discussion Framework
Artifact Editor	Code Artifact Editor
Ramble	Voice Note Transcription

All projects follow the same patterns and can be created using new-project.