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_searchor 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.