bc-code-intelligence-mcp 1.6.0 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (155) hide show
  1. package/LICENSE +20 -20
  2. package/README.md +165 -165
  3. package/dist/config/config-loader.js +6 -6
  4. package/dist/config/config-loader.js.map +1 -1
  5. package/dist/layers/embedded-layer.js +29 -29
  6. package/dist/layers/git-layer.d.ts +2 -0
  7. package/dist/layers/git-layer.d.ts.map +1 -1
  8. package/dist/layers/git-layer.js +47 -14
  9. package/dist/layers/git-layer.js.map +1 -1
  10. package/dist/layers/project-layer.js +33 -33
  11. package/dist/services/methodology-service.js +28 -28
  12. package/dist/services/multi-content-layer-service.d.ts +5 -0
  13. package/dist/services/multi-content-layer-service.d.ts.map +1 -1
  14. package/dist/services/multi-content-layer-service.js +31 -0
  15. package/dist/services/multi-content-layer-service.js.map +1 -1
  16. package/dist/tools/create_layer_content/handler.js +83 -83
  17. package/dist/tools/scaffold_layer_repo/handler.js +276 -276
  18. package/dist/tools/workflow_batch/schema.js +9 -9
  19. package/dist/tools/workflow_cancel/schema.js +9 -9
  20. package/dist/tools/workflow_complete/schema.js +9 -9
  21. package/dist/tools/workflow_list/schema.js +11 -11
  22. package/dist/tools/workflow_next/schema.js +8 -8
  23. package/dist/tools/workflow_progress/schema.js +5 -5
  24. package/dist/tools/workflow_start/schema.js +14 -14
  25. package/dist/tools/workflow_status/schema.js +8 -8
  26. package/embedded-knowledge/.github/ISSUE_TEMPLATE/bug-report.md +23 -23
  27. package/embedded-knowledge/.github/ISSUE_TEMPLATE/content-improvement.md +23 -23
  28. package/embedded-knowledge/.github/ISSUE_TEMPLATE/knowledge-request.md +29 -29
  29. package/embedded-knowledge/AGENTS.md +177 -177
  30. package/embedded-knowledge/CONTRIBUTING.md +57 -57
  31. package/embedded-knowledge/LICENSE +20 -20
  32. package/embedded-knowledge/README.md +31 -31
  33. package/embedded-knowledge/codelens-mappings.yaml +111 -111
  34. package/embedded-knowledge/domains/shared/al-file-naming-conventions.md +155 -155
  35. package/embedded-knowledge/scripts/frontmatter_validator.ps1 +330 -330
  36. package/embedded-knowledge/workflows/bc-version-upgrade.yaml +160 -160
  37. package/embedded-knowledge/workflows/code-review.yaml +148 -148
  38. package/embedded-knowledge/workflows/error-to-errorinfo-migration.yaml +137 -137
  39. package/embedded-knowledge/workflows/onboarding.yaml +124 -124
  40. package/embedded-knowledge/workflows/performance-audit.yaml +148 -148
  41. package/embedded-knowledge/workflows/proposal-review.yaml +117 -117
  42. package/embedded-knowledge/workflows/security-audit.yaml +139 -139
  43. package/package.json +83 -83
  44. package/dist/services/roleplay-engine.d.ts +0 -169
  45. package/dist/services/roleplay-engine.d.ts.map +0 -1
  46. package/dist/services/roleplay-engine.js +0 -1026
  47. package/dist/services/roleplay-engine.js.map +0 -1
  48. package/dist/streamlined-handlers.d.ts +0 -8
  49. package/dist/streamlined-handlers.d.ts.map +0 -1
  50. package/dist/streamlined-handlers.js +0 -29
  51. package/dist/streamlined-handlers.js.map +0 -1
  52. package/dist/tools/advance_workflow/handler.d.ts +0 -21
  53. package/dist/tools/advance_workflow/handler.d.ts.map +0 -1
  54. package/dist/tools/advance_workflow/handler.js +0 -58
  55. package/dist/tools/advance_workflow/handler.js.map +0 -1
  56. package/dist/tools/advance_workflow/schema.d.ts +0 -8
  57. package/dist/tools/advance_workflow/schema.d.ts.map +0 -1
  58. package/dist/tools/advance_workflow/schema.js +0 -28
  59. package/dist/tools/advance_workflow/schema.js.map +0 -1
  60. package/dist/tools/config-diagnostic-tools.d.ts +0 -234
  61. package/dist/tools/config-diagnostic-tools.d.ts.map +0 -1
  62. package/dist/tools/config-diagnostic-tools.js +0 -887
  63. package/dist/tools/config-diagnostic-tools.js.map +0 -1
  64. package/dist/tools/context-snapshot/handler.d.ts +0 -14
  65. package/dist/tools/context-snapshot/handler.d.ts.map +0 -1
  66. package/dist/tools/context-snapshot/handler.js +0 -143
  67. package/dist/tools/context-snapshot/handler.js.map +0 -1
  68. package/dist/tools/context-snapshot/schema.d.ts +0 -11
  69. package/dist/tools/context-snapshot/schema.d.ts.map +0 -1
  70. package/dist/tools/context-snapshot/schema.js +0 -46
  71. package/dist/tools/context-snapshot/schema.js.map +0 -1
  72. package/dist/tools/core-tools.d.ts +0 -26
  73. package/dist/tools/core-tools.d.ts.map +0 -1
  74. package/dist/tools/core-tools.js +0 -262
  75. package/dist/tools/core-tools.js.map +0 -1
  76. package/dist/tools/get_workflow_help/handler.d.ts +0 -12
  77. package/dist/tools/get_workflow_help/handler.d.ts.map +0 -1
  78. package/dist/tools/get_workflow_help/handler.js +0 -54
  79. package/dist/tools/get_workflow_help/handler.js.map +0 -1
  80. package/dist/tools/get_workflow_help/schema.d.ts +0 -8
  81. package/dist/tools/get_workflow_help/schema.d.ts.map +0 -1
  82. package/dist/tools/get_workflow_help/schema.js +0 -25
  83. package/dist/tools/get_workflow_help/schema.js.map +0 -1
  84. package/dist/tools/handoff-tools.d.ts +0 -37
  85. package/dist/tools/handoff-tools.d.ts.map +0 -1
  86. package/dist/tools/handoff-tools.js +0 -265
  87. package/dist/tools/handoff-tools.js.map +0 -1
  88. package/dist/tools/knowledge-query/handler.d.ts +0 -29
  89. package/dist/tools/knowledge-query/handler.d.ts.map +0 -1
  90. package/dist/tools/knowledge-query/handler.js +0 -85
  91. package/dist/tools/knowledge-query/handler.js.map +0 -1
  92. package/dist/tools/knowledge-query/schema.d.ts +0 -12
  93. package/dist/tools/knowledge-query/schema.d.ts.map +0 -1
  94. package/dist/tools/knowledge-query/schema.js +0 -64
  95. package/dist/tools/knowledge-query/schema.js.map +0 -1
  96. package/dist/tools/onboarding-tools.d.ts +0 -43
  97. package/dist/tools/onboarding-tools.d.ts.map +0 -1
  98. package/dist/tools/onboarding-tools.js +0 -353
  99. package/dist/tools/onboarding-tools.js.map +0 -1
  100. package/dist/tools/specialist-consult/handler.d.ts +0 -23
  101. package/dist/tools/specialist-consult/handler.d.ts.map +0 -1
  102. package/dist/tools/specialist-consult/handler.js +0 -120
  103. package/dist/tools/specialist-consult/handler.js.map +0 -1
  104. package/dist/tools/specialist-consult/schema.d.ts +0 -11
  105. package/dist/tools/specialist-consult/schema.d.ts.map +0 -1
  106. package/dist/tools/specialist-consult/schema.js +0 -47
  107. package/dist/tools/specialist-consult/schema.js.map +0 -1
  108. package/dist/tools/specialist-discovery-tools.d.ts +0 -27
  109. package/dist/tools/specialist-discovery-tools.d.ts.map +0 -1
  110. package/dist/tools/specialist-discovery-tools.js +0 -281
  111. package/dist/tools/specialist-discovery-tools.js.map +0 -1
  112. package/dist/tools/specialist-list/handler.d.ts +0 -14
  113. package/dist/tools/specialist-list/handler.d.ts.map +0 -1
  114. package/dist/tools/specialist-list/handler.js +0 -70
  115. package/dist/tools/specialist-list/handler.js.map +0 -1
  116. package/dist/tools/specialist-list/schema.d.ts +0 -11
  117. package/dist/tools/specialist-list/schema.d.ts.map +0 -1
  118. package/dist/tools/specialist-list/schema.js +0 -29
  119. package/dist/tools/specialist-list/schema.js.map +0 -1
  120. package/dist/tools/start_bc_workflow/handler.d.ts +0 -21
  121. package/dist/tools/start_bc_workflow/handler.d.ts.map +0 -1
  122. package/dist/tools/start_bc_workflow/handler.js +0 -237
  123. package/dist/tools/start_bc_workflow/handler.js.map +0 -1
  124. package/dist/tools/start_bc_workflow/schema.d.ts +0 -8
  125. package/dist/tools/start_bc_workflow/schema.d.ts.map +0 -1
  126. package/dist/tools/start_bc_workflow/schema.js +0 -43
  127. package/dist/tools/start_bc_workflow/schema.js.map +0 -1
  128. package/dist/tools/workflow-execute/handler.d.ts +0 -44
  129. package/dist/tools/workflow-execute/handler.d.ts.map +0 -1
  130. package/dist/tools/workflow-execute/handler.js +0 -333
  131. package/dist/tools/workflow-execute/handler.js.map +0 -1
  132. package/dist/tools/workflow-execute/schema.d.ts +0 -13
  133. package/dist/tools/workflow-execute/schema.d.ts.map +0 -1
  134. package/dist/tools/workflow-execute/schema.js +0 -108
  135. package/dist/tools/workflow-execute/schema.js.map +0 -1
  136. package/dist/tools/workflow_start_v2/handler.d.ts +0 -21
  137. package/dist/tools/workflow_start_v2/handler.d.ts.map +0 -1
  138. package/dist/tools/workflow_start_v2/handler.js +0 -133
  139. package/dist/tools/workflow_start_v2/handler.js.map +0 -1
  140. package/dist/tools/workflow_start_v2/schema.d.ts +0 -8
  141. package/dist/tools/workflow_start_v2/schema.d.ts.map +0 -1
  142. package/dist/tools/workflow_start_v2/schema.js +0 -102
  143. package/dist/tools/workflow_start_v2/schema.js.map +0 -1
  144. package/dist/tools/workspace-tools.d.ts +0 -96
  145. package/dist/tools/workspace-tools.d.ts.map +0 -1
  146. package/dist/tools/workspace-tools.js +0 -188
  147. package/dist/tools/workspace-tools.js.map +0 -1
  148. package/dist/types/roleplay-types.d.ts +0 -156
  149. package/dist/types/roleplay-types.d.ts.map +0 -1
  150. package/dist/types/roleplay-types.js +0 -8
  151. package/dist/types/roleplay-types.js.map +0 -1
  152. package/dist/workflows/domain-workflows.d.ts +0 -8
  153. package/dist/workflows/domain-workflows.d.ts.map +0 -1
  154. package/dist/workflows/domain-workflows.js +0 -360
  155. package/dist/workflows/domain-workflows.js.map +0 -1
@@ -5,17 +5,17 @@
5
5
  */
6
6
  export const workflowListTool = {
7
7
  name: 'workflow_list',
8
- description: `List all available BC Code Intelligence workflows.
9
-
10
- Use this tool to discover structured workflows that can guide the user through complex processes like code reviews, debugging, or app development.
11
-
12
- Returns a list of available workflows with:
13
- - workflow_type: The ID to pass to workflow_start
14
- - name: Human-readable workflow name
15
- - description: What the workflow helps with
16
- - specialist: The recommended specialist for this workflow
17
- - phases: The phases/steps in the workflow
18
-
8
+ description: `List all available BC Code Intelligence workflows.
9
+
10
+ Use this tool to discover structured workflows that can guide the user through complex processes like code reviews, debugging, or app development.
11
+
12
+ Returns a list of available workflows with:
13
+ - workflow_type: The ID to pass to workflow_start
14
+ - name: Human-readable workflow name
15
+ - description: What the workflow helps with
16
+ - specialist: The recommended specialist for this workflow
17
+ - phases: The phases/steps in the workflow
18
+
19
19
  Call this early in conversations to see if a workflow matches the user's intent.`,
20
20
  inputSchema: {
21
21
  type: 'object',
@@ -5,14 +5,14 @@
5
5
  */
6
6
  export const workflowNextTool = {
7
7
  name: 'workflow_next',
8
- description: `Get the next action to perform in a workflow session.
9
-
10
- Call this when you're ready for the next task. The engine returns:
11
- - Current progress (phase, files completed, percent)
12
- - Current file's checklist status
13
- - Next action with explicit instructions
14
- - Tool call suggestions for the action
15
-
8
+ description: `Get the next action to perform in a workflow session.
9
+
10
+ Call this when you're ready for the next task. The engine returns:
11
+ - Current progress (phase, files completed, percent)
12
+ - Current file's checklist status
13
+ - Next action with explicit instructions
14
+ - Tool call suggestions for the action
15
+
16
16
  The agent MUST follow the next_action instructions exactly.`,
17
17
  inputSchema: {
18
18
  type: 'object',
@@ -5,11 +5,11 @@
5
5
  */
6
6
  export const workflowProgressTool = {
7
7
  name: 'workflow_progress',
8
- description: `Report progress on current workflow action and get the next action.
9
-
10
- Call this after completing each action (analyzing a file, applying a topic, converting an instance).
11
- Include any findings, proposed changes, and topics to add to the checklist.
12
-
8
+ description: `Report progress on current workflow action and get the next action.
9
+
10
+ Call this after completing each action (analyzing a file, applying a topic, converting an instance).
11
+ Include any findings, proposed changes, and topics to add to the checklist.
12
+
13
13
  The engine updates session state and returns the next action to perform.`,
14
14
  inputSchema: {
15
15
  type: 'object',
@@ -5,20 +5,20 @@
5
5
  */
6
6
  export const workflowStartTool = {
7
7
  name: 'workflow_start',
8
- description: `Start a workflow session - a stateful checklist management system that drives agents through systematic, file-by-file processing.
9
-
10
- Workflows provide:
11
- - File inventory with per-file checklists
12
- - Dynamic checklist expansion based on analysis
13
- - Pattern scanning for migrations (e.g., Error→ErrorInfo)
14
- - Batch operations for large-scale changes
15
- - Progress tracking and session persistence
16
-
17
- The workflow drives the agent with explicit next-action instructions.
18
-
19
- Example usage:
20
- - Start a code review: workflow_type="code-review"
21
- - Start an error migration: workflow_type="error-to-errorinfo-migration"
8
+ description: `Start a workflow session - a stateful checklist management system that drives agents through systematic, file-by-file processing.
9
+
10
+ Workflows provide:
11
+ - File inventory with per-file checklists
12
+ - Dynamic checklist expansion based on analysis
13
+ - Pattern scanning for migrations (e.g., Error→ErrorInfo)
14
+ - Batch operations for large-scale changes
15
+ - Progress tracking and session persistence
16
+
17
+ The workflow drives the agent with explicit next-action instructions.
18
+
19
+ Example usage:
20
+ - Start a code review: workflow_type="code-review"
21
+ - Start an error migration: workflow_type="error-to-errorinfo-migration"
22
22
  - Start a BC upgrade: workflow_type="bc-version-upgrade" with source_version and target_version`,
23
23
  inputSchema: {
24
24
  type: 'object',
@@ -5,14 +5,14 @@
5
5
  */
6
6
  export const workflowStatusTool = {
7
7
  name: 'workflow_status',
8
- description: `Get current workflow v2 session status without advancing.
9
-
10
- Returns:
11
- - Overall progress (phase, percent complete)
12
- - Summary of findings by severity
13
- - Summary of proposed changes
14
- - Optionally: status of all files
15
-
8
+ description: `Get current workflow v2 session status without advancing.
9
+
10
+ Returns:
11
+ - Overall progress (phase, percent complete)
12
+ - Summary of findings by severity
13
+ - Summary of proposed changes
14
+ - Optionally: status of all files
15
+
16
16
  Use this to check on workflow progress or recover context after interruption.`,
17
17
  inputSchema: {
18
18
  type: 'object',
@@ -1,24 +1,24 @@
1
- ---
2
- name: Content Bug Report
3
- about: Report incorrect or outdated BC knowledge
4
- title: '[BUG] '
5
- labels: ['bug', 'content-error']
6
- assignees: ''
7
- ---
8
-
9
- ## Content Bug Report
10
-
11
- ### Affected Content
12
- Which file(s) or topic(s) contain the error?
13
-
14
- ### Bug Description
15
- What information is incorrect or outdated?
16
-
17
- ### Expected Content
18
- What should the correct information be?
19
-
20
- ### BC Version Context
21
- Which BC versions are affected by this error?
22
-
23
- ### Evidence
1
+ ---
2
+ name: Content Bug Report
3
+ about: Report incorrect or outdated BC knowledge
4
+ title: '[BUG] '
5
+ labels: ['bug', 'content-error']
6
+ assignees: ''
7
+ ---
8
+
9
+ ## Content Bug Report
10
+
11
+ ### Affected Content
12
+ Which file(s) or topic(s) contain the error?
13
+
14
+ ### Bug Description
15
+ What information is incorrect or outdated?
16
+
17
+ ### Expected Content
18
+ What should the correct information be?
19
+
20
+ ### BC Version Context
21
+ Which BC versions are affected by this error?
22
+
23
+ ### Evidence
24
24
  Any links, documentation, or testing that supports the correction?
@@ -1,24 +1,24 @@
1
- ---
2
- name: Content Improvement
3
- about: Suggest improvements to existing knowledge content
4
- title: '[IMPROVEMENT] '
5
- labels: ['enhancement', 'content-improvement']
6
- assignees: ''
7
- ---
8
-
9
- ## Content Improvement Suggestion
10
-
11
- ### Target Content
12
- Which file(s) or topic(s) need improvement?
13
-
14
- ### Issue Description
15
- What is incorrect, unclear, or missing?
16
-
17
- ### Proposed Changes
18
- What specific improvements do you suggest?
19
-
20
- ### BC Version Impact
21
- Do the changes affect BC version compatibility?
22
-
23
- ### Additional Context
1
+ ---
2
+ name: Content Improvement
3
+ about: Suggest improvements to existing knowledge content
4
+ title: '[IMPROVEMENT] '
5
+ labels: ['enhancement', 'content-improvement']
6
+ assignees: ''
7
+ ---
8
+
9
+ ## Content Improvement Suggestion
10
+
11
+ ### Target Content
12
+ Which file(s) or topic(s) need improvement?
13
+
14
+ ### Issue Description
15
+ What is incorrect, unclear, or missing?
16
+
17
+ ### Proposed Changes
18
+ What specific improvements do you suggest?
19
+
20
+ ### BC Version Impact
21
+ Do the changes affect BC version compatibility?
22
+
23
+ ### Additional Context
24
24
  Any additional context, links, or examples that would help?
@@ -1,30 +1,30 @@
1
- ---
2
- name: Knowledge Topic Request
3
- about: Request new BC knowledge topic or enhancement to existing topic
4
- title: '[KNOWLEDGE] '
5
- labels: ['enhancement', 'knowledge-request']
6
- assignees: ''
7
- ---
8
-
9
- ## Knowledge Topic Request
10
-
11
- ### BC Domain
12
- Which BC domain does this relate to? (performance, api-design, security, etc.)
13
-
14
- ### Topic Description
15
- What specific BC concept or pattern should be documented?
16
-
17
- ### BC Version Context
18
- Which BC versions does this apply to?
19
-
20
- ### Use Case
21
- What scenario or problem would this knowledge help solve?
22
-
23
- ### Existing Resources
24
- Are there any existing resources, documentation, or examples for this topic?
25
-
26
- ### Priority
27
- - [ ] Critical (blocking development)
28
- - [ ] High (significant impact)
29
- - [ ] Medium (helpful enhancement)
1
+ ---
2
+ name: Knowledge Topic Request
3
+ about: Request new BC knowledge topic or enhancement to existing topic
4
+ title: '[KNOWLEDGE] '
5
+ labels: ['enhancement', 'knowledge-request']
6
+ assignees: ''
7
+ ---
8
+
9
+ ## Knowledge Topic Request
10
+
11
+ ### BC Domain
12
+ Which BC domain does this relate to? (performance, api-design, security, etc.)
13
+
14
+ ### Topic Description
15
+ What specific BC concept or pattern should be documented?
16
+
17
+ ### BC Version Context
18
+ Which BC versions does this apply to?
19
+
20
+ ### Use Case
21
+ What scenario or problem would this knowledge help solve?
22
+
23
+ ### Existing Resources
24
+ Are there any existing resources, documentation, or examples for this topic?
25
+
26
+ ### Priority
27
+ - [ ] Critical (blocking development)
28
+ - [ ] High (significant impact)
29
+ - [ ] Medium (helpful enhancement)
30
30
  - [ ] Low (nice to have)
@@ -1,178 +1,178 @@
1
- # AGENTS.md - Repository Context for AI Assistants
2
-
3
- ## Repository Purpose
4
- This is the **knowledge content repository** for the BC Code Intelligence (bc-code-intel) system.
5
-
6
- ## What This Repo Contains
7
- - **BC Domain Knowledge**: 87+ atomic topics across 24 domains (performance, API design, security, etc.)
8
- - **Methodology Frameworks**: Step-by-step AI workflow guidance for systematic optimization
9
- - **Specialists Definitions**: 14 AI persona configurations with domain expertise and behavioral constraints
10
- - **Strategic Prompts**: High-level prompts for common BC development scenarios
11
- - **Pure Markdown Content**: No code whatsoever - only knowledge content with YAML frontmatter
12
-
13
- ## What This Repo Does NOT Contain
14
- - TypeScript/JavaScript code (that's in bc-code-intelligence-mcp repository)
15
- - MCP server implementation or protocol handling
16
- - Build processes, dependencies, or package.json files
17
- - Compiled or generated content
18
-
19
- ## Repository Structure
20
- ```
21
- domains/ # BC knowledge organized by domain
22
- ├── performance/ # Performance optimization patterns
23
- ├── api-design/ # REST/OData API best practices
24
- ├── data-architecture/ # Table design and relationships
25
- ├── security/ # Authentication and authorization
26
- └── [20 other domains]/
27
-
28
- methodologies/ # AI workflow frameworks
29
- ├── phases/ # Systematic analysis phases
30
- └── workflows/ # Complete optimization workflows
31
-
32
- specialists/ # AI persona definitions
33
- ├── alex-architect.md # Strategic Planning & Architecture
34
- ├── casey-copilot.md # AI-Enhanced Development Coach
35
- ├── dean-debug.md # Performance & Troubleshooting
36
- ├── eva-errors.md # Error Handling & Exception Management
37
- ├── jordan-bridge.md # Systems Connection & Event-Driven Design
38
- ├── logan-legacy.md # Legacy Code & Version Migration
39
- ├── maya-mentor.md # Learning & Skill Development
40
- ├── morgan-market.md # AppSource & ISV Business Expert
41
- ├── quinn-tester.md # Quality Validation & Test Design
42
- ├── roger-reviewer.md # Code Quality & Review Standards
43
- ├── sam-coder.md # Efficient Implementation Expert
44
- ├── seth-security.md # Security & Permission Management
45
- ├── taylor-docs.md # Documentation & Knowledge Management
46
- └── uma-ux.md # User Experience & Interface Design
47
-
48
- prompts/ # Strategic prompts
49
- ├── analyze-performance.md
50
- ├── review-architecture.md
51
- └── [other prompts]/
52
- ```
53
-
54
- ## Content Standards
55
- - **Atomic Topics**: One focused concept per markdown file
56
- - **YAML Frontmatter**: Rich metadata for AI consumption including:
57
- - BC version compatibility (`bc_versions: "14+"`)
58
- - Difficulty level, tags, domain classification
59
- - Cross-references to related topics
60
- - **Version Awareness**: All content specifies BC version compatibility
61
- - **Consistent Structure**: Follow established patterns for headings, examples, cross-references
62
-
63
- ## AI Assistant Guidelines When Working With This Repo
64
- 1. **Content Focus**: Maintain accuracy of BC technical information
65
- 2. **Structure Integrity**: Preserve YAML frontmatter completeness and consistency
66
- 3. **Version Compatibility**: Always specify BC version ranges for patterns/features
67
- 4. **Cross-References**: Maintain accurate links between related topics
68
- 5. **Atomic Principle**: Keep each file focused on one specific concept
69
- 6. **NO CODE**: This repository contains NO executable code - knowledge only
70
- 7. **Link Integrity**: Ensure internal topic references remain valid
71
-
72
- ## GitHub Copilot Coding Agent Guidelines
73
-
74
- ### Content Creation Patterns
75
- When creating new knowledge topics, ALWAYS use this YAML frontmatter template:
76
- ```yaml
77
- ---
78
- title: "Descriptive Topic Title"
79
- domain: "performance|api-design|security|etc"
80
- bc_versions: "14+|18+|19+|specific-range"
81
- difficulty: "beginner|intermediate|advanced"
82
- tags: ["tag1", "tag2", "tag3"]
83
- related_topics:
84
- - "path/to/related/topic.md"
85
- - "another/related/topic.md"
86
- applies_to:
87
- - "AL Language"
88
- - "Business Central Server"
89
- - "Web Client"
90
- last_updated: "2025-01-01"
91
- ---
92
- ```
93
-
94
- ### File Naming Conventions
95
- - Use kebab-case for all filenames: `api-pagination-patterns.md`
96
- - Include domain prefix when needed: `performance-caching-strategies.md`
97
- - Keep names descriptive but concise (max 50 characters)
98
- - Avoid abbreviations unless universally understood
99
-
100
- ### Content Structure Requirements
101
- 1. **H1 Title**: Must match YAML frontmatter title exactly
102
- 2. **Overview Section**: 2-3 sentence summary of the concept
103
- 3. **Implementation Details**: Step-by-step guidance with BC code examples
104
- 4. **Best Practices**: Bulleted list of key recommendations
105
- 5. **Common Pitfalls**: What to avoid with explanations
106
- 6. **Version Notes**: BC version-specific considerations
107
- 7. **See Also**: Cross-references to related topics
108
-
109
- ### Cross-Reference Validation
110
- - Use relative paths: `../performance/caching-strategies.md`
111
- - Verify target files exist before creating references
112
- - Update both directions when creating new relationships
113
- - Use descriptive link text: `[API Pagination Patterns](../api-design/pagination-patterns.md)`
114
-
115
- ### Domain Organization Rules
116
- ```
117
- domains/
118
- ├── performance/ # Speed, memory, resource optimization
119
- ├── api-design/ # REST, OData, integration patterns
120
- ├── security/ # Authentication, authorization, data protection
121
- ├── data-architecture/ # Table design, relationships, normalization
122
- ├── error-handling/ # Exception management, validation
123
- ├── testing/ # Unit, integration, performance testing
124
- └── [other domains]/ # Maintain alphabetical order
125
- ```
126
-
127
- ### Validation Checklist
128
- Before committing new content, verify:
129
- - [ ] YAML frontmatter is complete and valid
130
- - [ ] BC version compatibility is specified
131
- - [ ] Cross-references use relative paths and exist
132
- - [ ] Content is atomic (one focused concept)
133
- - [ ] No executable code is included
134
- - [ ] Examples use realistic BC scenarios
135
- - [ ] Tags are consistent with existing taxonomy
136
-
137
- ### Common Anti-Patterns to Avoid
138
- - ❌ **Code Repositories**: Never include .cs, .al, .js, or executable files
139
- - ❌ **Generic Examples**: Avoid "MyTable" - use realistic BC entities
140
- - ❌ **Version Ambiguity**: Never omit BC version compatibility
141
- - ❌ **Broken Cross-References**: Always validate links before committing
142
- - ❌ **Topic Drift**: Keep each file focused on ONE concept
143
- - ❌ **Outdated Information**: Update last_updated when making changes
144
-
145
- ## Common Tasks
146
- - Adding new BC knowledge topics with proper frontmatter and validation
147
- - Updating existing topics for new BC versions with migration notes
148
- - Creating bidirectional cross-references between related topics
149
- - Validating YAML frontmatter structure and consistency
150
- - Organizing content within domain hierarchies and maintaining taxonomy
151
- - Performing content audits for accuracy and BC version compatibility
152
-
153
- ## GitHub Copilot Integration Workflows
154
-
155
- ### New Topic Creation Workflow
156
- 1. **Domain Classification**: Determine primary domain from existing taxonomy
157
- 2. **Version Research**: Identify minimum BC version and any version-specific notes
158
- 3. **Template Application**: Use YAML frontmatter template with all required fields
159
- 4. **Content Development**: Follow structure requirements for consistency
160
- 5. **Cross-Reference Integration**: Add to related topics and update existing references
161
- 6. **Validation**: Run through validation checklist before committing
162
-
163
- ### Content Update Workflow
164
- 1. **Impact Assessment**: Identify which BC versions are affected
165
- 2. **Cross-Reference Review**: Check if related topics need updates
166
- 3. **Version Compatibility**: Update bc_versions field if needed
167
- 4. **Last Updated**: Always update timestamp when making changes
168
- 5. **Validation**: Ensure all links and references remain valid
169
-
170
- ### Quality Assurance Patterns
171
- - **Atomic Content Principle**: Each file covers exactly one BC concept
172
- - **Consistent Terminology**: Use official Microsoft BC terminology
173
- - **Practical Examples**: Include realistic Business Central scenarios
174
- - **Version Awareness**: Every pattern specifies BC version compatibility
175
- - **Link Validation**: Cross-references must be bidirectional and accurate
176
-
177
- ## Integration
1
+ # AGENTS.md - Repository Context for AI Assistants
2
+
3
+ ## Repository Purpose
4
+ This is the **knowledge content repository** for the BC Code Intelligence (bc-code-intel) system.
5
+
6
+ ## What This Repo Contains
7
+ - **BC Domain Knowledge**: 87+ atomic topics across 24 domains (performance, API design, security, etc.)
8
+ - **Methodology Frameworks**: Step-by-step AI workflow guidance for systematic optimization
9
+ - **Specialists Definitions**: 14 AI persona configurations with domain expertise and behavioral constraints
10
+ - **Strategic Prompts**: High-level prompts for common BC development scenarios
11
+ - **Pure Markdown Content**: No code whatsoever - only knowledge content with YAML frontmatter
12
+
13
+ ## What This Repo Does NOT Contain
14
+ - TypeScript/JavaScript code (that's in bc-code-intelligence-mcp repository)
15
+ - MCP server implementation or protocol handling
16
+ - Build processes, dependencies, or package.json files
17
+ - Compiled or generated content
18
+
19
+ ## Repository Structure
20
+ ```
21
+ domains/ # BC knowledge organized by domain
22
+ ├── performance/ # Performance optimization patterns
23
+ ├── api-design/ # REST/OData API best practices
24
+ ├── data-architecture/ # Table design and relationships
25
+ ├── security/ # Authentication and authorization
26
+ └── [20 other domains]/
27
+
28
+ methodologies/ # AI workflow frameworks
29
+ ├── phases/ # Systematic analysis phases
30
+ └── workflows/ # Complete optimization workflows
31
+
32
+ specialists/ # AI persona definitions
33
+ ├── alex-architect.md # Strategic Planning & Architecture
34
+ ├── casey-copilot.md # AI-Enhanced Development Coach
35
+ ├── dean-debug.md # Performance & Troubleshooting
36
+ ├── eva-errors.md # Error Handling & Exception Management
37
+ ├── jordan-bridge.md # Systems Connection & Event-Driven Design
38
+ ├── logan-legacy.md # Legacy Code & Version Migration
39
+ ├── maya-mentor.md # Learning & Skill Development
40
+ ├── morgan-market.md # AppSource & ISV Business Expert
41
+ ├── quinn-tester.md # Quality Validation & Test Design
42
+ ├── roger-reviewer.md # Code Quality & Review Standards
43
+ ├── sam-coder.md # Efficient Implementation Expert
44
+ ├── seth-security.md # Security & Permission Management
45
+ ├── taylor-docs.md # Documentation & Knowledge Management
46
+ └── uma-ux.md # User Experience & Interface Design
47
+
48
+ prompts/ # Strategic prompts
49
+ ├── analyze-performance.md
50
+ ├── review-architecture.md
51
+ └── [other prompts]/
52
+ ```
53
+
54
+ ## Content Standards
55
+ - **Atomic Topics**: One focused concept per markdown file
56
+ - **YAML Frontmatter**: Rich metadata for AI consumption including:
57
+ - BC version compatibility (`bc_versions: "14+"`)
58
+ - Difficulty level, tags, domain classification
59
+ - Cross-references to related topics
60
+ - **Version Awareness**: All content specifies BC version compatibility
61
+ - **Consistent Structure**: Follow established patterns for headings, examples, cross-references
62
+
63
+ ## AI Assistant Guidelines When Working With This Repo
64
+ 1. **Content Focus**: Maintain accuracy of BC technical information
65
+ 2. **Structure Integrity**: Preserve YAML frontmatter completeness and consistency
66
+ 3. **Version Compatibility**: Always specify BC version ranges for patterns/features
67
+ 4. **Cross-References**: Maintain accurate links between related topics
68
+ 5. **Atomic Principle**: Keep each file focused on one specific concept
69
+ 6. **NO CODE**: This repository contains NO executable code - knowledge only
70
+ 7. **Link Integrity**: Ensure internal topic references remain valid
71
+
72
+ ## GitHub Copilot Coding Agent Guidelines
73
+
74
+ ### Content Creation Patterns
75
+ When creating new knowledge topics, ALWAYS use this YAML frontmatter template:
76
+ ```yaml
77
+ ---
78
+ title: "Descriptive Topic Title"
79
+ domain: "performance|api-design|security|etc"
80
+ bc_versions: "14+|18+|19+|specific-range"
81
+ difficulty: "beginner|intermediate|advanced"
82
+ tags: ["tag1", "tag2", "tag3"]
83
+ related_topics:
84
+ - "path/to/related/topic.md"
85
+ - "another/related/topic.md"
86
+ applies_to:
87
+ - "AL Language"
88
+ - "Business Central Server"
89
+ - "Web Client"
90
+ last_updated: "2025-01-01"
91
+ ---
92
+ ```
93
+
94
+ ### File Naming Conventions
95
+ - Use kebab-case for all filenames: `api-pagination-patterns.md`
96
+ - Include domain prefix when needed: `performance-caching-strategies.md`
97
+ - Keep names descriptive but concise (max 50 characters)
98
+ - Avoid abbreviations unless universally understood
99
+
100
+ ### Content Structure Requirements
101
+ 1. **H1 Title**: Must match YAML frontmatter title exactly
102
+ 2. **Overview Section**: 2-3 sentence summary of the concept
103
+ 3. **Implementation Details**: Step-by-step guidance with BC code examples
104
+ 4. **Best Practices**: Bulleted list of key recommendations
105
+ 5. **Common Pitfalls**: What to avoid with explanations
106
+ 6. **Version Notes**: BC version-specific considerations
107
+ 7. **See Also**: Cross-references to related topics
108
+
109
+ ### Cross-Reference Validation
110
+ - Use relative paths: `../performance/caching-strategies.md`
111
+ - Verify target files exist before creating references
112
+ - Update both directions when creating new relationships
113
+ - Use descriptive link text: `[API Pagination Patterns](../api-design/pagination-patterns.md)`
114
+
115
+ ### Domain Organization Rules
116
+ ```
117
+ domains/
118
+ ├── performance/ # Speed, memory, resource optimization
119
+ ├── api-design/ # REST, OData, integration patterns
120
+ ├── security/ # Authentication, authorization, data protection
121
+ ├── data-architecture/ # Table design, relationships, normalization
122
+ ├── error-handling/ # Exception management, validation
123
+ ├── testing/ # Unit, integration, performance testing
124
+ └── [other domains]/ # Maintain alphabetical order
125
+ ```
126
+
127
+ ### Validation Checklist
128
+ Before committing new content, verify:
129
+ - [ ] YAML frontmatter is complete and valid
130
+ - [ ] BC version compatibility is specified
131
+ - [ ] Cross-references use relative paths and exist
132
+ - [ ] Content is atomic (one focused concept)
133
+ - [ ] No executable code is included
134
+ - [ ] Examples use realistic BC scenarios
135
+ - [ ] Tags are consistent with existing taxonomy
136
+
137
+ ### Common Anti-Patterns to Avoid
138
+ - ❌ **Code Repositories**: Never include .cs, .al, .js, or executable files
139
+ - ❌ **Generic Examples**: Avoid "MyTable" - use realistic BC entities
140
+ - ❌ **Version Ambiguity**: Never omit BC version compatibility
141
+ - ❌ **Broken Cross-References**: Always validate links before committing
142
+ - ❌ **Topic Drift**: Keep each file focused on ONE concept
143
+ - ❌ **Outdated Information**: Update last_updated when making changes
144
+
145
+ ## Common Tasks
146
+ - Adding new BC knowledge topics with proper frontmatter and validation
147
+ - Updating existing topics for new BC versions with migration notes
148
+ - Creating bidirectional cross-references between related topics
149
+ - Validating YAML frontmatter structure and consistency
150
+ - Organizing content within domain hierarchies and maintaining taxonomy
151
+ - Performing content audits for accuracy and BC version compatibility
152
+
153
+ ## GitHub Copilot Integration Workflows
154
+
155
+ ### New Topic Creation Workflow
156
+ 1. **Domain Classification**: Determine primary domain from existing taxonomy
157
+ 2. **Version Research**: Identify minimum BC version and any version-specific notes
158
+ 3. **Template Application**: Use YAML frontmatter template with all required fields
159
+ 4. **Content Development**: Follow structure requirements for consistency
160
+ 5. **Cross-Reference Integration**: Add to related topics and update existing references
161
+ 6. **Validation**: Run through validation checklist before committing
162
+
163
+ ### Content Update Workflow
164
+ 1. **Impact Assessment**: Identify which BC versions are affected
165
+ 2. **Cross-Reference Review**: Check if related topics need updates
166
+ 3. **Version Compatibility**: Update bc_versions field if needed
167
+ 4. **Last Updated**: Always update timestamp when making changes
168
+ 5. **Validation**: Ensure all links and references remain valid
169
+
170
+ ### Quality Assurance Patterns
171
+ - **Atomic Content Principle**: Each file covers exactly one BC concept
172
+ - **Consistent Terminology**: Use official Microsoft BC terminology
173
+ - **Practical Examples**: Include realistic Business Central scenarios
174
+ - **Version Awareness**: Every pattern specifies BC version compatibility
175
+ - **Link Validation**: Cross-references must be bidirectional and accurate
176
+
177
+ ## Integration
178
178
  This repository is consumed by the MCP server via git submodule as the embedded knowledge layer (Layer 0).