Imported from alawein/alawein (AGENTS.md). Install upstream with npx skills add alawein/alawein. Copyright stays with the author.

AGENTS: alawein

Workspace identity

This repo is the control plane for the alawein workspace. It owns shared governance, README/profile generation, style rules, prompt kits, and managed rollout scripts for the sibling repos. Disk layout SSOT is catalog/buckets.yaml plus docs/governance/repo-topology-canon.md. Portfolio lanes are catalog/index.yaml. Resolve sibling paths via catalog local_path under the bucketed workspace root (apps|core|lab|sites|work/<slug>).

Governance sources

• docs/governance/repo-topology-canon.md
• docs/governance/workspace-master-prompt.md
• docs/governance/parallel-batch-execution.md
• docs/governance/documentation-contract.md
• docs/governance/control-plane.md
• docs/style/VOICE.md
• prompt-kits/AGENT.md
• prompt-kits/PORTFOLIO.md
• SSOT.md

Governance rules

1. Keep README.md aligned with the current portfolio and canonical repo metadata.
2. Keep catalog/index.yaml as the human-edited catalog source; build-catalog.py compiles it to catalog/repos.json and derived outputs including projects.json.
3. Keep README entrypoints frontmatter-free and path-validated.
4. Treat VOICE.md and prompt-kits/ as the canonical style authority.
5. Fix generators and validators instead of patching synced output by hand.
6. Use manifest-driven batch execution for multi-repo rollout work.
7. Do not store secrets, build artifacts, or incidental local files in this repo.
8. Do not use destructive git operations to force consistency.
9. Agents may author commits per each repo's commit_mode (default full), authored as contact@meshal.ai with no AI attribution. Two invariants always apply: never commit secrets, and confirm before force-push or history rewrite on a shared branch. See docs/governance/commit-release-convention.md.
10. Meshal is the sole maintainer and final approver. Before execution, record the assigned scope and executor in the task or batch. Follow the role rotation in operating-model.md and the change evidence contract. A separate tool reviews the revision when feasible. Record unavailable review and pending acceptance explicitly; a skill or commit mode does not grant access.

Never

• Do not import, copy, commit, summarize, or operate on material from AGI Inc, theagi.company accounts, or an AGI-named cloud workspace into Alawein or Kohyr work. Prior-employer artifacts stay on Meshal's machine under Desktop/AGI, outside Desktop/GitHub/alawein. Existing audit mentions stay as evidence. Do not extend them.

Ask first

• Before changing governance template structure across the repo fleet
• Before changing canonical naming policy
• Before adding new automation that rewrites managed docs or repo surfaces

Quick reference

Notes

• profile-from-guides.yaml is the public-profile declaration surface.
• Cursor rules under .cursor/rules/ are committed governance text in this repo and should be treated like other maintained instruction surfaces.
• For profile-sync or README About-block work, follow the dedicated governance runbooks instead of inventing ad hoc flows.
• Shared session prompt: prompt-kits/AGENT.md 1.7.0. Search open catalog-land PRs before editing that kit or catalog/agent-integrations.yaml.
• Windows workspace root is Desktop/GitHub/alawein. This checkout is core/alawein.