Goal
Remove the near-duplicate "Initiative" Project field option and reconcile
docs/github-workflow.md's two conflicting descriptions of how Area/
Initiative option lists are defined.
Background
A documentation review of the process/workflow docs, cross-checked against
the live GitHub Project (basefoundry/base, project #10), found:
- The Project's actual "Initiative" field currently has two near-duplicate
options: BanyanLabs Dogfood and BanyanLabs Dogfooding (confirmed via
gh project field-list 10 --owner basefoundry), with no indication which
is canonical. docs/github-workflow.md:116-117 and
.github/base-project.yml:16-17 both faithfully reproduce this duplicate
in their option lists rather than catching it as a bug.
docs/github-workflow.md:113-118 gives Area/Initiative as fixed,
concrete option lists in the "Issue Project Metadata" section, but the same
document's later "Projects" section (:730-732) describes them instead as
"repo-specific options declared in .github/base-project.yml," with no
cross-link connecting the two framings — a reader can't tell whether the
list in front of them is authoritative or just an example.
Scope
Acceptance Criteria
Validation
gh project field-list 10 --owner basefoundry --format json after the
change, confirming a single BanyanLabs-dogfooding option; git diff --check
on the doc changes.
Non-Goals
- Renaming or restructuring other Project fields beyond the Initiative
duplicate.
Project Metadata
- Priority: P2
- Size: S
- Area: Docs
- Initiative: Adoption Polish
- Agent Assignment: Human first (touches live GitHub Project configuration,
not just doc text — needs a human to confirm no in-flight items use the
option being removed before deleting it)
Goal
Remove the near-duplicate "Initiative" Project field option and reconcile
docs/github-workflow.md's two conflicting descriptions of how Area/Initiative option lists are defined.
Background
A documentation review of the process/workflow docs, cross-checked against
the live GitHub Project (
basefoundry/base, project #10), found:options:
BanyanLabs DogfoodandBanyanLabs Dogfooding(confirmed viagh project field-list 10 --owner basefoundry), with no indication whichis canonical.
docs/github-workflow.md:116-117and.github/base-project.yml:16-17both faithfully reproduce this duplicatein their option lists rather than catching it as a bug.
docs/github-workflow.md:113-118givesArea/Initiativeas fixed,concrete option lists in the "Issue Project Metadata" section, but the same
document's later "Projects" section (
:730-732) describes them instead as"repo-specific options declared in
.github/base-project.yml," with nocross-link connecting the two framings — a reader can't tell whether the
list in front of them is authoritative or just an example.
Scope
.github/base-project.ymlbasefoundry)docs/github-workflow.mdAcceptance Criteria
the BanyanLabs dogfooding work (either
BanyanLabs DogfoodorBanyanLabs Dogfooding, not both), and any existing items using theremoved option are migrated first.
.github/base-project.ymlmatches the reconciled option list.docs/github-workflow.md:113-118and:730-732are reconciled so it'sclear in one place whether the Area/Initiative lists shown are
authoritative or
.github/base-project.ymlis the single source oftruth (with the other section linking to it instead of restating it).
Validation
gh project field-list 10 --owner basefoundry --format jsonafter thechange, confirming a single BanyanLabs-dogfooding option;
git diff --checkon the doc changes.
Non-Goals
duplicate.
Project Metadata
not just doc text — needs a human to confirm no in-flight items use the
option being removed before deleting it)