n4m3z/AdaptPrompts

AdaptPrompts

Take a source rule set and adapt it for a target repo that consumes the lib submodule as infrastructure but has its own identity.

Instructions

1. Read the target repo's rules/ directory. Classify each file:

   • Custom — exists only in the target (e.g., IndustrySecrets.md, ScanRepository.md). Never touch these.
   • Adapted — same filename as a source rule but with modifications (paths: frontmatter, content changes). Preserve the adaptation, update the base content if the source changed.
   • Identical — exact copy of a source rule. Candidate for update or removal.
   • Missing — source rule has no counterpart in the target. Candidate for addition.

2. Read the source rule set. Default source: the module that owns this skill (forge-core/rules/). The user can specify a different source.

3. For each source rule, decide relevance to the target:

   | Rule type | Action | |-----------|--------| | Generic development (KeepChangelog, KeepCodeowners, UseRTK, GitConventions, LessIsMore, PlatformAgnostic, SanitizeData) | Port — these apply to any repo | | Module-specific (ChooseLicense, MakefileFirst, AuthorInModules, CanonSidecar, SkillNaming) | Skip unless the target is a forge module | | Forge-branded (ContextualNaming) | Skip — meta-rule about adaptation itself | | Provider-specific (CodexAgents, GeminiAgents, AgentTeams) | Port only if the target uses agents | | Memory/tooling (MemoryFiles, KnownIssues, ShellAliases) | Port only if relevant to the target's stack |

4. For each rule being ported, apply these transformations:

   • Strip forge branding per ContextualNaming: "forge-cli" becomes "the CLI tool", "forge-core" becomes "the core module", skill names drop forge prefix.
   • Add paths: frontmatter when the rule should be scoped (e.g., SelfLearning.md scoped to the target's skill paths).
   • Preserve existing adaptations — if the target already has a modified version, merge source updates into the existing adaptation rather than overwriting.
   • Match the target's naming — if the target uses different filenames, rename accordingly.

5. Present the adaptation plan as a table before making changes:

   | Source rule | Target status | Action | Notes |
   |-------------|---------------|--------|-------|
   | UseRTK.md | Identical copy (old name RTK.md) | Rename + update | Content unchanged |
   | KeepChangelog.md | Missing | Add | Generic, applies to any repo |
   | ChooseLicense.md | N/A | Skip | Module-specific |
   

6. Ask the user to confirm before writing. Apply changes with the Write tool.

7. After writing, list the final rules/ directory contents grouped by origin:

   • Custom (target-only)
   • Adapted (source + modifications)
   • Ported (source, unmodified)

Constraints

• Never overwrite custom rules — they represent domain knowledge that doesn't exist in the source
• Never add forge branding to non-forge repos — the target's identity is its own
• Always present the plan before writing — no silent rule installation
• Adapted rules keep the target's modifications; only the base content updates from source
• If a rule was renamed in the source (e.g., RTK.md → UseRTK.md), rename in the target too