codealta-monorepo
/codealta-monorepo
Use this skill to set a repository up as a monorepo in CodeAlta, or to change how it is set up - find the folders that are projects of their own (services, apps, libraries, git submodules), propose them with the labels that organize them, write the project map `.alta/projects.toml` with `alta project manifest`, and keep it right when the repository changes.
- Author
- codealta ↗
- Repository
- codealta ↗
- Licence
- BSD-2-Clause
- Last repository change
- 13.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.
BSD-2-Clause, otwarta.
What it does and when to use it
Use this skill to set a repository up as a monorepo in CodeAlta, or to change how it is set up - find the folders that are projects of their own (services, apps, libraries, git submodules), propose them with the labels that organize them, write the project map `.alta/projects.toml` with `alta project manifest`, and keep it right when the repository changes.
Original author description
Use this skill to set a repository up as a monorepo in CodeAlta, or to change how it is set up - find the folders that are projects of their own (services, apps, libraries, git submodules), propose them with the labels that organize them, write the project map `.alta/projects.toml` with `alta project manifest`, and keep it right when the repository changes.
How it works
- 1. Read the repository
- 2. Propose, then ask
- 3. Write the map
- 4. Finish
- A map inside a sub-project
- Keep it right
SKILL.md preview
--- name: codealta-monorepo description: Use this skill to set a repository up as a monorepo in CodeAlta, or to change how it is set up - find the folders that are projects of their own (services, apps, libraries, git submodules), propose them with the labels that organize them, write the project map `.alta/projects.toml` with `alta project manifest`, and keep it right when the repository changes. --- # Set a monorepo up A repository declares the folders of it that are projects of their own in its project map, `.alta/projects.toml`, a file committed with it. Whoever adds the repository to CodeAlta gets every sub-project, grouped under the repository with the labels of the map, each with its own sessions, plans, tasks, skills and agents, on top of the setup of the repository. A sub-project is any folder: a service, an app, a library, a git submodule, a folder inside a submodule. You cannot write under `.alta/` with your file tools: change the map with `alta project manifest`. Each command answers with JSON records; `alta project manifest <command> --help` gives its options. ## 1. Read the repository - `alta project manifest show` - the map as CodeAlta reads it: its labels, its projects with the state of their folders, and its problems. Without a map, it says `exists: false`. In a sub-project, it shows the map of its repository, or its own map when it has one (see "A map inside a sub-project"). - `alta project manifest scan` - the folders that hold a project (a `package.json`, a `.csproj`, `Cargo.toml`, `go.mod`, `pyproject.toml`, ...) three levels down, the git submodules, and the files that tell how the repository is organized. Narrow it with `--glob "services/*"` (repeat it), choose what marks a project with `--marker`, go deeper with `--depth`. - Read the workspace files the scan names (`alta.project.manifest.workspace`): `pnpm-workspace.yaml`, the `workspaces` of `package.json`, `Cargo.toml` (`[workspace] members`), `go.work`, `nx.json` and the `project.json` files, `turbo.json`, `WORKSPACE`/`MODULE.bazel`, the `.sln` files, `settings.gradle`, `.gitmodules`. - Read `CODEOWNERS` when there is one: the teams that own folders are good labels. - Read the `AGENTS.md` of the root and of the folders, and the readme: they tell what each part is for. ## 2. Propose, then ask A package is not always a project. A project is a folder someone works in on its own: a service, an app, a tool, a library with its own life. Small shared packages, generated code, fixtures, examples and documentation are usually not. Propose to the user, in one short message: - the sub-projects: key, folder, name, and why; - the labels that organize them (by team, by layer, by product), with at most two levels unless the repository asks for more; - the folders you leave out, and why; - the ones to mark `optional` (listed only for those who add them): large or rarely used parts; - the ones whose sessions should write only their folder (`write = folder`): parts where a change must never touch the rest. Wait for the user's answer before you write the map, unless they asked you to go ahead. ## 3. Write the map ```text alta project manifest label backend --name Backend --icon server --color #2d72d2 alta project manifest label payments --name Payments --parent backend alta project manifest add services/billing --name Billing --label payments --description "Invoices and payment collection." alta project manifest add apps/web --name Web --label frontend alta project manifest add tools/reports --optional alta project manifest set web --write folder alta project manifest show ``` - A key is lower-case letters, digits, `-` and `_`. It is the identity of the sub-project: its folder can move (`set <key> --path <new folder>`) and it keeps its sessions. Choose keys that will last. - A label that `add` or `set` names and the map does not declare is created, named from its key: name it with `label`. - Every change is checked: a change that would add a problem to the map is refused with the reason. - End with `alta project manifest show`: no problem, every folder `ok`. ## 4. Finish - The map is a file of the repository: tell the user to review it in Changes and commit it, so that everyone who adds the repository gets the same projects. The user also sees and edits it in CodeAlta Desktop, with **Sub-projects…** in the menu of the repository. - Offer an `AGENTS.md` for the sub-projects that have none: what the folder is, how to build and test it, its conventions. The `AGENTS.md` of the root still applies to them. - What a sub-project inherits from the repository: the `AGENTS.md` of every folder above it, the skills, prompts and MCP servers of the repository (its own win on a name), its `.alta/config.toml` under its own. Its plans and tasks are its own. Say so when the user wonders where to put something. ## A map inside a sub-project A sub-project can have a map of its own, a nested map: a repository cloned inside this one (`repos/billing` with its own `.git`), or a large folder that the team organizes on its own. It is a repository too, with its labels and sub-projects, nested under its repository in CodeAlta Desktop. - Choose where a sub-project is declared: in the map of the nearest repository that owns it. A cloned repository keeps its map in its own repository, so that it works alone too. - `alta project manifest <command> --project <sub-project>` works on the map of that sub-project; in a session of a sub-project with a map, the commands work on its own map without `--project`. - `alta project manifest show` names the repository above in `parentId`, and the entries that have a map of their own in `subProjects`. - Maps nest four levels deep. A folder two maps declare belongs to the nearer one: the outer map lists the entry as a problem (`folder.claimed`); remove it there. A map too deep (`map.tooDeep`), or one that a link leads back to (`map.loop`), is not read: declare those projects in a map above it. ## Keep it right - A folder that moved: `alta project manifest set <key> --path <new folder>`. - A project that is gone: `alta project manifest remove <key>`; its folder and its sessions stay. - New folders: `alta project manifest scan` lists them with `declared` empty. - `alta project list --parent <repository>` lists the sub-projects as projects; `alta project show <sub-project>` names its repository.
Versions
The database has no other skills named codealta-monorepo.
Database snapshot: 13.11.2026 · package version b8cec58d6b88 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95codealta-plugin-runtime
Use this skill to create, change, build, reload, test or troubleshoot a CodeAlta plugin - C# code that adds commands, dialogs, status items, agent tools, alta commands, prompt text or timeline cards to CodeAlta. - 100codealta-fleet
Use this skill to work with the CodeAlta fleet - the machines this computer is paired with or reaches through a CodeAlta Server - to pick a machine for a task (capabilities, tags, readiness, load), start or steer a session on another machine, move a session, place or run an… - 100nx-import
Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository. - 100select-project
This skill should be used when the user wants to switch between projects in a monorepo - lists projects from .groundwork.yml and sets the active project - 100monorepo-delivery
Deliver changes in this monorepo through Git-Spice, focused checks, Woodpecker CI, automated review, and PR evidence. Use for branches, commits, PRs, CI failures, review findings, or release-readiness claims. - 91monorepo-workflows
Use when setting up CI/CD, implementing versioning, optimizing workflows, or managing releases with monorepo development workflows including version management, publishing, and team collaboration practices.