Skip to content
Skills Library
DevOps & cloud · Automation

argentos-dev-ops

/argentos-dev-ops

ArgentOS development operations workflow — Linear tracking, CodeRabbit reviews, Blacksmith CI, GitHub branch protection, and inter-agent handoff protocol. Use when working on any ArgentOS repo, creating PRs, managing CI/CD, coordinating between agents, syncing installers, or setting up new project infrastructure. Trigger on mentions of Linear, CodeRabbit, Blacksmith, branch protection, handoff, installer sync, or dev workflow.

Licence
MIT
Last repository change
08.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 08.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

ArgentOS development operations workflow — Linear tracking, CodeRabbit reviews, Blacksmith CI, GitHub branch protection, and inter-agent handoff protocol. Use when working on any ArgentOS repo, creating PRs, managing CI/CD, coordinating between agents, syncing installers, or setting up new project infrastructure. Trigger on mentions of Linear, CodeRabbit, Blacksmith, branch protection, handoff, installer sync, or dev workflow.

Original author description

ArgentOS development operations workflow — Linear tracking, CodeRabbit reviews, Blacksmith CI, GitHub branch protection, and inter-agent handoff protocol. Use when working on any ArgentOS repo, creating PRs, managing CI/CD, coordinating between agents, syncing installers, or setting up new project infrastructure. Trigger on mentions of Linear, CodeRabbit, Blacksmith, branch protection, handoff, installer sync, or dev workflow.

How it works

  1. Repos and Ownership
  2. Linear — Source of Truth
  3. CodeRabbit — PR Review
  4. Blacksmith — CI Runners
  5. GitHub Branch Protection
  6. Inter-Agent Handoff
  7. Installer Sync
  8. Shared Infrastructure
  9. PR Workflow
Original SKILL.md headings · 105 lines, 473 words
SKILL.md preview
---
name: argentos-dev-ops
description: ArgentOS development operations workflow — Linear tracking, CodeRabbit reviews, Blacksmith CI, GitHub branch protection, and inter-agent handoff protocol. Use when working on any ArgentOS repo, creating PRs, managing CI/CD, coordinating between agents, syncing installers, or setting up new project infrastructure. Trigger on mentions of Linear, CodeRabbit, Blacksmith, branch protection, handoff, installer sync, or dev workflow.
---

# ArgentOS Development Operations

Standard operating procedures for all ArgentOS development across five repos.

## Repos and Ownership

| Repo                 | Agent  | Purpose                                      |
| -------------------- | ------ | -------------------------------------------- |
| `argentos`           | Codex  | Private monorepo — full OS source            |
| `argentos-core`      | Codex  | Public core — exported from argentos         |
| `argentos.ai`        | Claude | Marketing website + newsletter + analytics   |
| `argent-marketplace` | Claude | Marketplace — catalog, submissions, scanning |
| `argent-docs`        | Claude | Documentation site (Fumadocs + Next.js)      |

## Linear — Source of Truth

Workspace: `webdevtoday`. Team key: `WEB`.

**Projects:** ArgentOS, AOS Website, AOS Marketplace, AOS Docs, AOS Licensing Server.

**Before starting work:** Find or create the Linear issue. Record active branch, target repo, acceptance criteria. Set to In Progress.

**During work:** Update with current blocker, commit/PR link, review gates. For release-facing work, track Blacksmith and CodeRabbit state.

**After work:** Link merged PR. Set to Done. Create handoff issue if cross-repo work is needed.

If Linear is unavailable, say so immediately. Do not pretend work is tracked.

## CodeRabbit — PR Review

Every PR gets CodeRabbit before human review.

```bash
pnpm review:coderabbit          # Full review
pnpm review:coderabbit:prompt   # Prompt-only for CI/agent handoff
```

Fix CodeRabbit findings before requesting human review. Configured at org level.

## Blacksmith — CI Runners

All argentos-core CI runs on Blacksmith runners. Track Blacksmith status in Linear for release work. Dashboard: https://blacksmith.sh

## GitHub Branch Protection

**argentos-core**: Direct push blocked. PRs required. CodeRabbit must pass.

**All other repos**: Direct push to main allowed for speed.

**Branches:** `codex/*` for Codex work, `feat/*` for features, `fix/*` for bugs.

## Inter-Agent Handoff

Two agents. Jason coordinates. Never modify another agent's repo without a handoff.

```
HANDOFF TO CLAUDE:  (website/marketplace/docs)
HANDOFF TO CODEX:   (argentos/argentos-core)

Linear: WEB-XX
Repo: target repo
Task: one-line summary
Context: what triggers this
What needs to happen: specific changes
Acceptance: how to verify
```

Update Linear and notify Jason after completing a handoff.

## Installer Sync

```
argentos/scripts/install-hosted.sh    ← source of truth (Codex)
  ↓
argentos.ai/scripts/install.sh        ← website copy (Claude syncs)
argentos.ai/public/install.sh         ← public copy (Claude syncs)
  ↓
https://argentos.ai/install.sh        ← live
```

Both website copies must be byte-for-byte identical. Verify: `curl -fsSL https://argentos.ai/install.sh | head -5`

## Shared Infrastructure

| Service      | Detail                                   |
| ------------ | ---------------------------------------- |
| PostgreSQL   | Railway, shared by website + marketplace |
| R2           | argentos-licensing-marketplace bucket    |
| Resend       | hello@argentos.ai                        |
| VirusTotal   | Package scanning (free, 500/day)         |
| GitHub OAuth | Marketplace (Ov23liooePHo3G5yoroe)       |
| Context7     | /websites/argentos_ai                    |

## PR Workflow

1. Branch from main.
2. Implement. `pnpm build` must pass.
3. `pnpm review:coderabbit` if available.
4. Push, create PR. CodeRabbit reviews.
5. Fix findings. Human review. Merge.
6. Update Linear with PR link and Done.

argentos-core: PR required. Other repos: direct push OK for urgent fixes.
Files in this package (2)
  • SKILL.md 4 KB
  • references/tracking-contract.md 2 KB

Versions

The database has no other skills named argentos-dev-ops.

Database snapshot: 13.11.2026 · package version 95efd62f7d31 (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

  • 100coderabbit-ci-integration
    Configure CodeRabbit CI/CD integration with GitHub Actions and testing. Use when setting up automated testing, configuring CI pipelines, or integrating CodeRabbit tests into your build process. Trigger with phrases like "coderabbit CI", "coderabbit GitHub Actions", "coderabbit…
  • 100argentos-release-checklist
    End-to-end release checklist for ArgentOS across all repos and services. Use when deploying a release, pushing to production, launching a feature across repos, doing a coordinated deploy, or when anyone mentions "release", "deploy", "launch", "go live", "push to prod", or "ship it".
  • 100argentos-repo-inventory
    Complete inventory of ArgentOS repos, databases, services, and infrastructure. Use when asking "which repo", "where does X live", "what database", "what table", "which service", "what port", "what env var", or when needing to understand the relationship between repos, services, and data.
  • 100coderabbit-multi-env-setup
    Configure CodeRabbit across development, staging, and production environments. Use when setting up multi-environment deployments, configuring per-environment secrets, or implementing environment-specific CodeRabbit configurations. Trigger with phrases like "coderabbit…
  • 95openclaw-ci-limits
    Manage OpenClaw GitHub Actions and Blacksmith CI capacity, runner-registration budgets, fanout caps, main-push single-flight, shard sizing, hosted-runner offload, queue health, and safe ramp-down/ramp-up changes. Use when tuning `.github/workflows/*`, `docs/ci.md`, CI runner…
  • 95openclaw-ci-limits
    Manage OpenClaw GitHub Actions and Blacksmith CI capacity, runner-registration budgets, fanout caps, main-push single-flight, shard sizing, hosted-runner offload, queue health, and safe ramp-down/ramp-up changes. Use when tuning `.github/workflows/*`, `docs/ci.md`, CI runner…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.