Creating a Task
Create a task at /repositories/:repositoryId/tasks/create to generate content from a repository that has completed pre-analysis.
When to use
- Use a documentation task to generate overview content, architecture analysis, Markdown, and diagrams.
- Use a backlog task to generate modernization planning artifacts.
- Use new tasks when you need to refresh or complement results.
Before you start
Confirm that:
- The correct organization is active.
- The repository has uploaded source code.
- Pre-analysis has completed.
- No conflicting task is already pending or running.
If the repository is not ready, return to the source code or overview tab and complete the recommended step first.
Task types
The available options depend on the current configuration, but the main task types are:
Technical Documentation
Generates repository documentation, including overview content, architecture analysis, Markdown output, and Mermaid diagrams when selected.
Backlog Generation
Generates backlog-oriented artifacts such as epics and supporting diagrams for planning modernization work.
Configuration
Each task asks for basic information such as name, description, task type, and output language. Depending on the selected type and environment configuration, the form can also include generation options:
- AI enrichment: enables richer documentation output and unlocks dependent options.
- Overview: creates a high-level repository overview.
- Architecture analysis: adds architecture-focused analysis.
- Generate diagrams: creates Mermaid diagrams when possible.
- Epics: generates backlog epics for modernization planning.
- Experimental graph: enables graph-related generation when available.
- Model selection: lets users choose models when AI configuration is enabled for the organization.
Choosing a generated output language other than English can add translation cost, depending on the environment configuration and model usage.
Expected result
After submitting the form, the application opens the task detail screen so users can follow status, logs, and available actions.