RepoFoundry/docs/project-plan.md

Project Plan

Metadata

Key	Value
ID	PP-001
CrossReference	BC-001, SA-001, MIL-001, MIL-002, MIL-003, MIL-004, MIL-005, US-001

Version History

Date	Status	Author	Reviewer	Change	Commit
2026-10-05	Deprecated	Jens Tirsvad Nielsen	S02	Added phase MIL-004 (proposed dates 2026-11-16 to 2026-11-20)	2a6bb8e
2026-10-06	Accepted	Jens Tirsvad Nielsen	S02	Added phase MIL-005 (proposed dates 2026-11-23 to 2026-11-27)	ded26a6

---

Purpose

Schedule the five phases that deliver RepoFoundry (create-project.sh and its documentation) in dependency order. The Business Case sets no deadline, so the dates below are proposals for S01 to confirm.

Planning Assumptions

• Week 1 starts 2026-10-05; the plan ends by 2026-11-27 (the last phase is proposed).
• Phase length: two weeks.
• S01 and S02 review each phase through a pull request, as described in SA-001. For now one person holds both roles.
• The PO language is English, so no translated copies are kept.

Gateway Schedule

Gateway	Document	Window	Decision date	Owner	Stories	Main deliverable	Milestone
Foundation	MIL-001	2026-10-05 to 2026-10-16	2026-10-16	S01	US-001.01	Safe skeleton, config parsing, prompts, tests	Milestone 43
Repositories and Mirror	MIL-002	2026-10-19 to 2026-10-30	2026-10-30	S02	US-001.02	GitHub and Gitea repositories and the push mirror	Milestone 44
Scaffold and Release	MIL-003	2026-11-02 to 2026-11-13	2026-11-13	S01	US-001.03	Local project, framework, README, final review	Milestone 45
Configurable Details	MIL-004	2026-11-16 to 2026-11-20	2026-11-20	S01	US-001.04	Project details preset in config.env
Credentials	MIL-005	2026-11-23 to 2026-11-27	2026-11-27	S01	US-001.05	Missing credentials asked; project .env

@startgantt
Project starts 2026-10-05
[Foundation] starts 2026-10-05 and ends 2026-10-16
[Foundation Go/No-Go] happens 2026-10-16
[Repositories and Mirror] starts 2026-10-19 and ends 2026-10-30
[Repositories and Mirror Go/No-Go] happens 2026-10-30
[Scaffold and Release] starts 2026-11-02 and ends 2026-11-13
[Scaffold and Release Go/No-Go] happens 2026-11-13
[Configurable Details] starts 2026-11-16 and ends 2026-11-20
[Configurable Details Go/No-Go] happens 2026-11-20
[Credentials] starts 2026-11-23 and ends 2026-11-27
[Credentials Go/No-Go] happens 2026-11-27
@endgantt

Scope Coverage

Business Case scope item	Gateway
Safe parsing of config.env and .env, tool checks, prompts, .gitignore	MIL-001
Project name check on GitHub	MIL-001
Creation of both repositories and the push mirror	MIL-002
Partial-failure reporting	MIL-002
Local directory, remotes, framework submodule, skills, hooks, templates, plan gate	MIL-003
README and SSH prerequisite documentation	MIL-003
Project details set in config.env instead of asked	MIL-004
Missing credentials asked; the new project's .env	MIL-005

Dependencies

MIL-001 → MIL-002 → MIL-003 → MIL-004 → MIL-005

A No-Go moves every later date by the time needed to rework the failed criteria.

Plan Risks

Risk	Impact	Mitigation
No disposable GitHub organization for testing	Organization-owner path untested	Agree the test owners before MIL-002 starts
Gitea API behaviour differs from the swagger on the live server	Mirror task takes longer	Test against git.tirsystem.com early in MIL-002

Open Issues

• Decided: the proposed dates are accepted with this plan (S01 asked for its acceptance on 2026-10-05); a change needs a new Version History row.
• Decided: origin uses HTTPS derived from GITEA_URL, unless the SSH test passed, in which case it uses SSH on port 10022.
• Decided: use case UC-001 "Create a new project" is created, with SSD-001; tasks that implement its steps reference it.
• Decided: S01 and S02 are both held by one person for now.
• Open: this plan says the script does not make the first commit; confirm before MIL-003 starts.

---