Prerequisites

Summarizes the prerequisites required before using NexusArchitect (Git repository, Issue tracker authentication, and conditions related to the GitLab Epic feature)

The prerequisites that were actually needed throughout the session are as follows.

Git Repository

• The target project must be a Git repository (if you don’t have one yet, start with git init).
• You must be in a state where you can push to a remote (GitLab or GitHub).
• Pushing the main branch to the remote at least once upfront is critically important.

Issue Tracker Authentication

NexusArchitect runs these CLIs internally. All issue creation, comments, label operations, and MR/PR creation and merging are performed through these CLIs.

GitLab Epic Group/Premium Requirements

GitLab has an Epic feature (a feature provided natively by GitLab) for managing multiple issues together. However, using this feature requires two conditions.

• The project must belong to a group (a unit that aggregates multiple people and multiple projects), not a personal account
• That group must be subscribed to a Premium/Ultimate plan (a paid GitLab plan)

In other words, projects under a personal account (personal namespace) cannot use the Epic feature directly. In that case, NexusArchitect automatically switches to an alternative approach (this switch is called a fallback). Specifically, it creates Epics, Sub-Epics, and Issues all as regular issues and distinguishes them with the labels type::epic, type::sub-epic, and type::issue. It also embeds a task list (- [ ] #<iid>) linking to child issues in the parent’s description.

If you are using a personal account, plan with the assumption that this label + task list approach will be used.