Modalitajiet Personalizzati: Code Review, Deploy, Lint
F'din il-paġna
Lezzjoni aġġornata fit-2 ta’ Novembru 2026. Il-fajls tal-aġenti issa jużaw iċ-ċwievet iddokumentati minn Vibe:
instructions(mhuxsystem_prompt),active_model(mhuxmodel), blokki[tools.<tool>]għall-approvazzjonijiet (iċ-ċavettaauto_approvema teżistix f’fajl tal-aġent), u ismijiet reali tal-għodod (edit, mhuxedit_file; l-ebda għoddalist_dir). Tfakkira mil-Lezzjoni 3:safetyhija indikatur viżiv, mhux permess. Sors: Configuration reference.
Oħloq modalitajiet adattati għax-xogħol tiegħek
Il-lezzjoni dwar il-modalitajiet unifikati introduċiet il-kunċett; issa wasal iż-żmien li ttestjah. Se nibnu tliet modalitajiet personalizzati li jkopru ħtiġijiet rikorrenti għal kull żviluppatur: reviżjoni tal-kodiċi, dispjegament (deployment), u linting. Kull wieħed huwa fajl .toml imqiegħed f’~/.vibe/agents/, b’istruzzjonijiet adattati. Dak li jiddistingwi dawn it-tliet modalitajiet mhux daqshekk l-istruzzjonijiet tagħhom, iżda l-par enabled_tools / [tools.<tool>]: dan jiddeċiedi x’jista’ jmiss Vibe, u għalhekk liema riskju qed tiffaċċja; safety hija sempliċiment it-tikketta viżiva.
Reviżur li ma jista’ jkisser xejn
Il-modalità ta’ reviżjoni tal-kodiċi (code review) tbiddel lil Vibe f’reviżur eżiġenti li janalizza l-kwalità, is-sigurtà u l-manutenibbiltà tal-kodiċi tiegħek. Peress li jaqra biss, huwa mmarkat bħala safe, u l-għodod tal-qari tiegħu huma stabbiliti għal permission = "always": jaħdem mingħajr ma jinterrompik, u mingħajr riskju peress li l-ebda fajl ma se jiġi mmodifikat. Il-lista tal-għodod iżżomm din il-wegħda: l-ebda write_file, l-ebda edit, l-ebda bash.
# ~/.vibe/agents/review.toml
display_name = "Code Review"
description = "In-depth code review: security, performance, maintainability."
safety = "safe"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
You are a senior developer in code review mode.
Process:
1. Read modified files (git diff or specified files)
2. Analyze each change across 4 axes:
- Security (injection, XSS, CSRF, exposed secrets)
- Performance (N+1, nested loops, memory)
- Maintainability (naming, complexity, duplication)
- Correctness (logic, edge cases, types)
Output format:
## 🔴 Critiques (fix before merge)
## 🟡 Warnings (fix soon)
## 🟢 Suggestions (optional improvements)
For each point: file, line, problem, proposed fix.
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Il-format tal-output infurzat fil-prompt mhuwiex kożmetiku: jippermettilek tissepara f’daqqa t’għajn dak li jimblokaw pull request u dak li jista’ jistenna. Tniedi l-modalità, imbagħad tagħtih jew istruzzjoni ħielsa jew ambitu speċifiku.
vibe --agent review
# > Analyze modified files in the current branch
# > /review src/api/
Dispjegament li jirrifjuta li jimprovviża
Il-modalità deploy hija l-eżatt oppost. Tmiss il-produzzjoni, għalhekk hija mmarkata bħala destructive, u l-għodod tal-kitba u bash tagħha jibqgħu f’permission = "ask": kull azzjoni teħtieġ il-validazzjoni tiegħek. Il-valur sħiħ tal-modalità jinsab fis-sekwenza fissa tal-prompt tagħha, u speċjalment fil-kundizzjonijiet ta’ waqfien tagħha. Dispjegament improvviżat ta’ Lejl il-Ġimgħa dejjem jibda b’pass maqfuż; hawnhekk, test ħamrani iwaqqaf kollox.
# ~/.vibe/agents/deploy.toml
display_name = "Deploy"
description = "Controlled deployment with tests, build, and verification."
safety = "destructive"
active_model = "codestral" # alias declared in config.toml (Lesson 2)
instructions = """
You are in deployment mode. Follow this sequence WITHOUT EXCEPTION:
1. VERIFY — clean git status, no uncommitted files
2. TEST — run the full test suite
3. BUILD — production build
4. VALIDATE — check the build (size, errors, warnings)
5. CONFIRM — ask the user before continuing
6. DEPLOY — run the deployment command
7. VERIFY — confirm the service responds correctly
If a step fails: STOP. Explain the problem and propose a solution.
Never deploy if tests fail.
Never deploy if the build contains critical warnings.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Il-preżenza ta’ ask_user_question fl-għodod hija essenzjali: mingħajrha, il-pass 5 ikun biss xewqa, peress li l-aġent ma jkollu l-ebda mod tekniku biex jistaqsik.
vibe --agent deploy
# > Follows the sequence test → build → deploy → verification
Tindifa awtomatika iżda dixxiplinata
Bejn iż-żewġt itruf hemm il-modalità lint, li tawtomatizza l-iffurmar (formatting), il-konvenzjonijiet u s-sortjar tal-importazzjonijiet. Timmodifika fajls, għalhekk hija neutral, iżda l-korrezzjonijiet tagħha huma mekkaniċi u reversibbli permezz ta’ Git: l-approvazzjoni tal-għodod tagħha minnufih (permission = "always") tiffrankalek milli tikklikkja ħamsin darba. Jekk il-lista tagħha tinkludi bash, agħmel dan biss f’ambjent iżolat, jew illimita bash għal allowlist ta’ kumandi ta’ lint biss. It-tliet regoli fl-aħħar tal-prompt huma dak li jżommha milli toħroġ mill-binarji—aġent li jaħdem ħieles malajr jinstalla Biome f’proġett li jgħix perfettament tajjeb b’ESLint.
# ~/.vibe/agents/lint.toml
display_name = "Lint & Fix"
description = "Automatic cleanup: lint, format, imports, conventions."
safety = "neutral"
active_model = "codestral" # alias declared in config.toml (Lesson 2)
instructions = """
You are in code cleanup mode.
Tasks:
1. Detect project tools (ESLint, Biome, Prettier, oxlint)
2. Run lint with auto-fix
3. Run formatting
4. Sort and clean up imports
5. Remove detectable dead code
6. Report errors that cannot be fixed automatically
Rules:
- Use tools already configured in the project
- Do not modify tool configuration
- Do not add new tools without asking
"""
enabled_tools = [
"read_file",
"edit",
"bash",
"grep",
]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.bash]
permission = "always" # reserve for isolated environments only
[tools.grep]
permission = "always"
Żewġ modalitajiet oħra, u regola ta’ organizzazzjoni
L-istess raġunament japplika għal ħtiġijiet oħra. Modalità tad-dokumentazzjoni tibqa’ neutral iżda żżomm write_file u edit f’"ask", għax il-ġenerazzjoni ta’ fajls f’repożitorju teħtieġ ħarsa qabel il-kitba.
# ~/.vibe/agents/docs.toml
display_name = "Documentation"
description = "Generates and updates technical documentation."
safety = "neutral"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
Generate technical documentation. For each file:
- JSDoc/TSDoc for public functions
- README with usage examples
- Documented environment variables
- API schemas if applicable
"""
enabled_tools = ["read_file", "write_file", "edit", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Modalità ta’ migrazzjoni, min-naħa l-oħra, tingħaqad ma’ deploy fil-kategorija destructive: migrazzjoni ta’ skema ħażina ma tistax titħassar b’git revert, għalhekk ir-rekwiżit għal skritt ta’ rollback sistematiku.
# ~/.vibe/agents/migrate.toml
display_name = "Migration"
description = "Handles database and dependency migrations."
safety = "destructive"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
You handle migrations. Absolute rules:
- Always generate a rollback script
- Test the migration on a copy before production
- Document every schema change
"""
enabled_tools = ["read_file", "write_file", "bash", "grep", "ask_user_question"]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Fl-aħħar nett, organizza d-direttorju tal-aġenti tiegħek sabiex il-kritikalità tkun leġibbli fis-siġra tal-istruttura nnifisha. Meta tbiddel il-modalitajiet permezz tat-tastiera f’nofs sessjoni, għandek bżonn tkun taf mingħajr ma taħseb jekk il-modalità li għadek kemm attivat tistax tikteb fuq id-disk tiegħek.
~/.vibe/agents/
├── review.toml # safe — read-only
├── lint.toml # neutral — controlled modifications
├── docs.toml # neutral — file generation
├── deploy.toml # destructive — with confirmation
└── migrate.toml # destructive — with confirmation
Punti Ewlenin
- Kull modalità hija fajl
.tomlf’~/.vibe/agents/iddisinjat għal fluss ta’ xogħol speċifiku - Il-modalità review għandha biss għodod tal-qari, approvati minnufih: tista’ taqra biss
- Il-modalità deploy iżżomm
bashu l-kitba f’"ask": titlob konferma - Il-modalità lint tapprova l-għodod tal-editjar tagħha minnufih: tissemma awtomatikament
- Aġġusta
active_modelskont il-kumplessità tal-kompitu - L-
instructionshuma ċ-ċavetta: kun preċiż dwar is-sekwenza u r-regoli