| name | add-project |
| description | Add a new project to config.json with auto-detection and validation. Detects settings from directory, validates GitLab/Jira access, optionally configures Quay/Bonfire, generates initial knowledge. Use when user says "add project", "configure new repo". Use when this capability is needed. |
| metadata | {"author":"dmzoneill"} |
Add Project
Adds a project to config.json with auto-detection, validation, and optional knowledge generation.
Inputs
| Input | Type | Required | Purpose |
|---|
path | string | yes | Path to project directory |
name | string | no | Project name (default: dir name) |
gitlab | string | no | GitLab path (auto-detect) |
jira_project | string | yes | Jira key (e.g., AAP, KONFLUX) |
jira_component | string | no | Jira component |
konflux_namespace | string | no | Konflux tenant namespace |
setup_quay | bool | false | Configure Quay |
setup_bonfire | bool | false | Configure Bonfire |
generate_knowledge | bool | true | Generate initial knowledge |
Workflow
1. Load Persona
persona_load("project") or developer for project tools
2. Check Known Issues
check_known_issues("gitlab_project_info")
3. Detect Settings
project_detect(path) — language, branch, gitlab, lint/test commands, scopes
4. Validate
- Verify path exists
- If gitlab:
gitlab_mr_list(project, state="opened") — verify access
jira_search or project tools — verify Jira access
5. Add Project
project_add(name, path, gitlab, jira_project, jira_component, konflux_namespace, auto_detect=true)
6. Optional Setup
- Quay: Output instructions for config.json quay.repositories
- Bonfire: Output instructions for bonfire.apps
7. Generate Knowledge (if requested)
knowledge_scan(project, persona="developer")code_index(project)code_watch(project, action="start")
8. Detect/Learn Failures
- "no such host" →
learn_tool_fix("gitlab_project_info", "no such host", "VPN", "vpn_connect()")
- "project not found", "project does not exist" → record patterns
9. Log & Track
memory_session_log("Added project {name}", "Path: ... GitLab: ...")memory_append("state/projects", "configured_projects", {...})
Output
Project name, config_updated, knowledge_generated, vector_index_created, watcher_running.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
