4

QUICKSTART_ORG_PROJECTS

Jonathan Miller edited this page 2026-05-11 21:56:12 +00:00

Table of Contents

• Quick Start: Auto-Create Organization Projects
• Prerequisites
• Option 1: Gitea Actions (Recommended)
• Option 2: Command Line
• Dry Run First (Recommended)
• Create Projects and Roadmaps
• What Gets Created
• For Each Repository
• Custom Fields by Type
• Quick Workflow
• Single Repository Mode
• Troubleshooting
• Next Steps After Creation
• Related

← Back to Home

Quick Start: Auto-Create Organization Projects

This guide provides a quick start for automatically creating smart GitHub Projects for all repositories in the mokoconsulting-tech organization.

---

Prerequisites

• GitHub Personal Access Token with permissions: repo, project, read:org
• Python 3.7+ with requests library installed

---

Option 1: Gitea Actions (Recommended)

1. Go to Actions tab in the moko-platform repository
2. Select "Auto-Create Organization Projects" workflow
3. Click "Run workflow"
4. Configure options:
   • Dry run: Check to preview without making changes (recommended first time)
   • Verbose: Check to enable detailed logging
5. Click "Run workflow"
6. Review the workflow logs and summary

The workflow automatically runs quarterly in dry-run mode to detect new repositories.

---

Option 2: Command Line

Dry Run First (Recommended)

python3 scripts/auto_create_org_projects.py --dry-run --verbose

Create Projects and Roadmaps

export GH_PAT="your_github_token"
python3 scripts/auto_create_org_projects.py --verbose

---

What Gets Created

For Each Repository

1. Project Type Detection -- Joomla, Dolibarr, or Generic
2. Roadmap Generation (if missing) -- Type-specific docs/ROADMAP.md
3. GitHub Project Creation -- Custom fields, standard views, type-specific views

Custom Fields by Type

All Projects	Joomla Adds	Dolibarr Adds	Generic Adds
Status, Priority, Size/Effort	Joomla Version	Dolibarr Version	Technology Stack
Sprint, Target Version	Extension Type	Module Number	Environment
Blocked Reason	Marketplace Status	Database Changes	Release Channel
Acceptance Criteria	PHP Minimum	Requires Sudo	Deployment Status

---

Quick Workflow

# 1. Test with dry run
python3 scripts/auto_create_org_projects.py --dry-run --verbose

# 2. Review the output

# 3. Run for real
export GH_PAT="your_token"
python3 scripts/auto_create_org_projects.py --verbose

# 4. Review created projects

Single Repository Mode

python3 scripts/create_repo_project.py REPO_NAME --type joomla
python3 scripts/create_repo_project.py REPO_NAME --type dolibarr
python3 scripts/create_repo_project.py REPO_NAME --type generic

---

Troubleshooting

Error	Solution
"GitHub token required"	export GH_PAT="ghp_your_token_here"
"Permission denied"	Verify token has repo, project, read:org scopes
"Failed to detect project type"	Script defaults to "generic" -- manually specify with --type
"Rate limit exceeded"	Wait a few minutes and retry

---

Next Steps After Creation

1. Review Projects: Visit each project and verify configuration
2. Customize Roadmaps: Edit generated roadmaps for specific needs
3. Add Issues: Populate projects with existing issues
4. Configure Automations: Set up workflow automations
5. Share with Team: Notify team members about new project boards

---

Related

• AUTO_CREATE_ORG_PROJECTS -- Full documentation
• ARCHITECTURE -- Platform scripts architecture

---

Repo: moko-platform · moko-platform wiki

Field	Value
Minimum Version	04.07.00
Platform	all
Applies To	All repositories

Revision	Date	Author	Description
1.0	2026-05-09	Moko Consulting	Initial version