refactor: make INSTANCE.md template and agent instructions generic

Remove agile-specific references (scrum masters, Jira/ADO tool selection,
com.snc.sdlc.agile.2.0) and broaden to cover all ServiceNow use cases.
Add sections for scoped apps, integrations, and naming conventions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: groeimetai

packages/opencode/src/project/agents-template.txt

@@ -202,13 +202,14 @@ You MUST follow instructions in this precedence order:
 
 **When to READ INSTANCE.md:**
 - At the start of a session to recall instance details (URL, version, active plugins, teams)
-- Before choosing between native SN agile tools vs enterprise Jira/ADO tools
-- When a user references something instance-specific (custom tables, teams, conventions)
+- When a user references something instance-specific (custom tables, integrations, naming conventions)
+- Before making assumptions about what exists or is configured on the instance
 
 **When to UPDATE INSTANCE.md:**
-- After discovering the instance URL or version
-- After confirming which plugins are active (especially `com.snc.sdlc.agile.2.0`)
-- After discovering custom tables, teams, or naming conventions
+- After discovering the instance URL, version, or edition
+- After confirming which plugins or modules are active
+- After discovering custom tables, scoped applications, or integrations
+- After learning about naming conventions, team structures, or key contacts
 - After creating significant update sets
 - When you learn something instance-specific that would be useful in future sessions
 

packages/opencode/src/project/instance-template.txt

@@ -9,24 +9,48 @@ across sessions. You can also manually edit this file.
 <!-- Agent: update this section after connecting to the instance -->
 - **URL**: (not yet discovered)
 - **Version**: (not yet discovered)
+- **Edition**: (e.g., Standard, Professional, Enterprise)
 
-## Active Plugins
+## Active Plugins & Modules
 
-<!-- Agent: update this section when you discover which plugins are active -->
-<!-- Example: com.snc.sdlc.agile.2.0, com.snc.change_management, etc. -->
+<!-- Agent: update this section when you discover which plugins/modules are active -->
+<!-- Examples: com.snc.change_management, com.snc.incident, com.snc.service_catalog,
+     com.snc.sdlc.agile.2.0, com.snc_hr_core, com.sn_csm, com.snc.cmdb,
+     com.snc.integration_hub, com.glide.itsm.virtual_agent, etc. -->
+
+## Custom Applications & Scopes
+
+<!-- Agent: record any scoped applications discovered (x_vendor_appname format) -->
+<!-- Include: app name, scope, purpose, version if known -->
 
 ## Custom Tables
 
 <!-- Agent: record any custom tables you discover during development -->
+<!-- Include: table name, label, extends (if any), purpose -->
+
+## Key Integrations
+
+<!-- Agent: record integration endpoints, REST messages, MID servers -->
+<!-- Examples: outbound REST to JIRA, inbound API for monitoring, LDAP/SSO config,
+     IntegrationHub spokes, import sources, SCCM/SCOM connections -->
+
+## Teams & Key Users
+
+<!-- Agent: record team names, roles, key contacts you interact with -->
+<!-- Examples: platform admin, process owners, fulfillers, assignment groups -->
 
-## Teams & Users
+## Naming Conventions & Standards
 
-<!-- Agent: record team names, scrum masters, key users you interact with -->
+<!-- Agent: record instance-specific naming patterns and development standards -->
+<!-- Examples: table prefixes (u_ vs x_vendor_), field naming, update set naming,
+     business rule naming, script include patterns, catalog item categories -->
 
 ## Development Notes
 
-<!-- Agent: record instance-specific patterns, quirks, or conventions -->
-<!-- Examples: naming conventions, custom fields, integration endpoints -->
+<!-- Agent: record instance-specific patterns, quirks, or configurations -->
+<!-- Examples: custom ACLs, domain separation setup, performance considerations,
+     specific GlideRecord patterns used, custom processors, custom UI pages,
+     notification configurations, approval workflows -->
 
 ## Update Set History