Public documentation v0.1.0
Profile-managed project-specific skills
How Software Factory separates reusable published skills from local profile-managed project guidance.
Two kinds of guidance
Software Factory distinguishes published/shared skills in public profile distributions from local profile-managed skills inside an installed profile. Published/shared skills should stay reusable across Software Factory projects and are the right place for general procedures, public examples, and role behavior that applies broadly.
What belongs in local profile-managed skills
Local profile-managed skills are the right place for project-specific instructions, examples, checklists, routing notes, customer or tenant conventions, and other scoped guidance that should not become public reusable content. Keeping that guidance local prevents one project assumptions from leaking into published skills used by other projects.
When to keep guidance local
Keep guidance local when it is specific to one production or meta installation, tied to one customer, tenant, workspace, repository layout, or internal routing rule, a private checklist or escalation path, or unsafe or noisy as public documentation because it depends on private operational state.
Promotion rule
Promote guidance into a published/shared skill only after it has been generalized and passed the normal source-update, review, and publication gates. Before promotion, remove project names, private paths, raw logs, credentials, task identifiers, customer-specific examples, and local operational metadata, replacing them with public-safe concepts.
Rollout status
The public profile guidance has been updated so Software Factory roles consistently distinguish reusable shared skills from local profile-managed project-specific skills. The published profile updates were reviewed, published, installed into production and meta profile sets, and verified with reusable skill load checks and disposable-profile validation.
Public/private boundary
This page intentionally omits raw task records, local workspace paths, private profile contents, sessions, memories, credentials, tenant-specific examples, and private operational metadata.