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.
- package/LICENSE +20 -20
- package/README.md +165 -165
- package/dist/config/config-loader.js +6 -6
- package/dist/config/config-loader.js.map +1 -1
- package/dist/layers/embedded-layer.js +29 -29
- package/dist/layers/git-layer.d.ts +2 -0
- package/dist/layers/git-layer.d.ts.map +1 -1
- package/dist/layers/git-layer.js +47 -14
- package/dist/layers/git-layer.js.map +1 -1
- package/dist/layers/project-layer.js +33 -33
- package/dist/services/methodology-service.js +28 -28
- package/dist/services/multi-content-layer-service.d.ts +5 -0
- package/dist/services/multi-content-layer-service.d.ts.map +1 -1
- package/dist/services/multi-content-layer-service.js +31 -0
- package/dist/services/multi-content-layer-service.js.map +1 -1
- package/dist/tools/create_layer_content/handler.js +83 -83
- package/dist/tools/scaffold_layer_repo/handler.js +276 -276
- package/dist/tools/workflow_batch/schema.js +9 -9
- package/dist/tools/workflow_cancel/schema.js +9 -9
- package/dist/tools/workflow_complete/schema.js +9 -9
- package/dist/tools/workflow_list/schema.js +11 -11
- package/dist/tools/workflow_next/schema.js +8 -8
- package/dist/tools/workflow_progress/schema.js +5 -5
- package/dist/tools/workflow_start/schema.js +14 -14
- package/dist/tools/workflow_status/schema.js +8 -8
- package/embedded-knowledge/.github/ISSUE_TEMPLATE/bug-report.md +23 -23
- package/embedded-knowledge/.github/ISSUE_TEMPLATE/content-improvement.md +23 -23
- package/embedded-knowledge/.github/ISSUE_TEMPLATE/knowledge-request.md +29 -29
- package/embedded-knowledge/AGENTS.md +177 -177
- package/embedded-knowledge/CONTRIBUTING.md +57 -57
- package/embedded-knowledge/LICENSE +20 -20
- package/embedded-knowledge/README.md +31 -31
- package/embedded-knowledge/codelens-mappings.yaml +111 -111
- package/embedded-knowledge/domains/shared/al-file-naming-conventions.md +155 -155
- package/embedded-knowledge/scripts/frontmatter_validator.ps1 +330 -330
- package/embedded-knowledge/workflows/bc-version-upgrade.yaml +160 -160
- package/embedded-knowledge/workflows/code-review.yaml +148 -148
- package/embedded-knowledge/workflows/error-to-errorinfo-migration.yaml +137 -137
- package/embedded-knowledge/workflows/onboarding.yaml +124 -124
- package/embedded-knowledge/workflows/performance-audit.yaml +148 -148
- package/embedded-knowledge/workflows/proposal-review.yaml +117 -117
- package/embedded-knowledge/workflows/security-audit.yaml +139 -139
- package/package.json +83 -83
- package/dist/services/roleplay-engine.d.ts +0 -169
- package/dist/services/roleplay-engine.d.ts.map +0 -1
- package/dist/services/roleplay-engine.js +0 -1026
- package/dist/services/roleplay-engine.js.map +0 -1
- package/dist/streamlined-handlers.d.ts +0 -8
- package/dist/streamlined-handlers.d.ts.map +0 -1
- package/dist/streamlined-handlers.js +0 -29
- package/dist/streamlined-handlers.js.map +0 -1
- package/dist/tools/advance_workflow/handler.d.ts +0 -21
- package/dist/tools/advance_workflow/handler.d.ts.map +0 -1
- package/dist/tools/advance_workflow/handler.js +0 -58
- package/dist/tools/advance_workflow/handler.js.map +0 -1
- package/dist/tools/advance_workflow/schema.d.ts +0 -8
- package/dist/tools/advance_workflow/schema.d.ts.map +0 -1
- package/dist/tools/advance_workflow/schema.js +0 -28
- package/dist/tools/advance_workflow/schema.js.map +0 -1
- package/dist/tools/config-diagnostic-tools.d.ts +0 -234
- package/dist/tools/config-diagnostic-tools.d.ts.map +0 -1
- package/dist/tools/config-diagnostic-tools.js +0 -887
- package/dist/tools/config-diagnostic-tools.js.map +0 -1
- package/dist/tools/context-snapshot/handler.d.ts +0 -14
- package/dist/tools/context-snapshot/handler.d.ts.map +0 -1
- package/dist/tools/context-snapshot/handler.js +0 -143
- package/dist/tools/context-snapshot/handler.js.map +0 -1
- package/dist/tools/context-snapshot/schema.d.ts +0 -11
- package/dist/tools/context-snapshot/schema.d.ts.map +0 -1
- package/dist/tools/context-snapshot/schema.js +0 -46
- package/dist/tools/context-snapshot/schema.js.map +0 -1
- package/dist/tools/core-tools.d.ts +0 -26
- package/dist/tools/core-tools.d.ts.map +0 -1
- package/dist/tools/core-tools.js +0 -262
- package/dist/tools/core-tools.js.map +0 -1
- package/dist/tools/get_workflow_help/handler.d.ts +0 -12
- package/dist/tools/get_workflow_help/handler.d.ts.map +0 -1
- package/dist/tools/get_workflow_help/handler.js +0 -54
- package/dist/tools/get_workflow_help/handler.js.map +0 -1
- package/dist/tools/get_workflow_help/schema.d.ts +0 -8
- package/dist/tools/get_workflow_help/schema.d.ts.map +0 -1
- package/dist/tools/get_workflow_help/schema.js +0 -25
- package/dist/tools/get_workflow_help/schema.js.map +0 -1
- package/dist/tools/handoff-tools.d.ts +0 -37
- package/dist/tools/handoff-tools.d.ts.map +0 -1
- package/dist/tools/handoff-tools.js +0 -265
- package/dist/tools/handoff-tools.js.map +0 -1
- package/dist/tools/knowledge-query/handler.d.ts +0 -29
- package/dist/tools/knowledge-query/handler.d.ts.map +0 -1
- package/dist/tools/knowledge-query/handler.js +0 -85
- package/dist/tools/knowledge-query/handler.js.map +0 -1
- package/dist/tools/knowledge-query/schema.d.ts +0 -12
- package/dist/tools/knowledge-query/schema.d.ts.map +0 -1
- package/dist/tools/knowledge-query/schema.js +0 -64
- package/dist/tools/knowledge-query/schema.js.map +0 -1
- package/dist/tools/onboarding-tools.d.ts +0 -43
- package/dist/tools/onboarding-tools.d.ts.map +0 -1
- package/dist/tools/onboarding-tools.js +0 -353
- package/dist/tools/onboarding-tools.js.map +0 -1
- package/dist/tools/specialist-consult/handler.d.ts +0 -23
- package/dist/tools/specialist-consult/handler.d.ts.map +0 -1
- package/dist/tools/specialist-consult/handler.js +0 -120
- package/dist/tools/specialist-consult/handler.js.map +0 -1
- package/dist/tools/specialist-consult/schema.d.ts +0 -11
- package/dist/tools/specialist-consult/schema.d.ts.map +0 -1
- package/dist/tools/specialist-consult/schema.js +0 -47
- package/dist/tools/specialist-consult/schema.js.map +0 -1
- package/dist/tools/specialist-discovery-tools.d.ts +0 -27
- package/dist/tools/specialist-discovery-tools.d.ts.map +0 -1
- package/dist/tools/specialist-discovery-tools.js +0 -281
- package/dist/tools/specialist-discovery-tools.js.map +0 -1
- package/dist/tools/specialist-list/handler.d.ts +0 -14
- package/dist/tools/specialist-list/handler.d.ts.map +0 -1
- package/dist/tools/specialist-list/handler.js +0 -70
- package/dist/tools/specialist-list/handler.js.map +0 -1
- package/dist/tools/specialist-list/schema.d.ts +0 -11
- package/dist/tools/specialist-list/schema.d.ts.map +0 -1
- package/dist/tools/specialist-list/schema.js +0 -29
- package/dist/tools/specialist-list/schema.js.map +0 -1
- package/dist/tools/start_bc_workflow/handler.d.ts +0 -21
- package/dist/tools/start_bc_workflow/handler.d.ts.map +0 -1
- package/dist/tools/start_bc_workflow/handler.js +0 -237
- package/dist/tools/start_bc_workflow/handler.js.map +0 -1
- package/dist/tools/start_bc_workflow/schema.d.ts +0 -8
- package/dist/tools/start_bc_workflow/schema.d.ts.map +0 -1
- package/dist/tools/start_bc_workflow/schema.js +0 -43
- package/dist/tools/start_bc_workflow/schema.js.map +0 -1
- package/dist/tools/workflow-execute/handler.d.ts +0 -44
- package/dist/tools/workflow-execute/handler.d.ts.map +0 -1
- package/dist/tools/workflow-execute/handler.js +0 -333
- package/dist/tools/workflow-execute/handler.js.map +0 -1
- package/dist/tools/workflow-execute/schema.d.ts +0 -13
- package/dist/tools/workflow-execute/schema.d.ts.map +0 -1
- package/dist/tools/workflow-execute/schema.js +0 -108
- package/dist/tools/workflow-execute/schema.js.map +0 -1
- package/dist/tools/workflow_start_v2/handler.d.ts +0 -21
- package/dist/tools/workflow_start_v2/handler.d.ts.map +0 -1
- package/dist/tools/workflow_start_v2/handler.js +0 -133
- package/dist/tools/workflow_start_v2/handler.js.map +0 -1
- package/dist/tools/workflow_start_v2/schema.d.ts +0 -8
- package/dist/tools/workflow_start_v2/schema.d.ts.map +0 -1
- package/dist/tools/workflow_start_v2/schema.js +0 -102
- package/dist/tools/workflow_start_v2/schema.js.map +0 -1
- package/dist/tools/workspace-tools.d.ts +0 -96
- package/dist/tools/workspace-tools.d.ts.map +0 -1
- package/dist/tools/workspace-tools.js +0 -188
- package/dist/tools/workspace-tools.js.map +0 -1
- package/dist/types/roleplay-types.d.ts +0 -156
- package/dist/types/roleplay-types.d.ts.map +0 -1
- package/dist/types/roleplay-types.js +0 -8
- package/dist/types/roleplay-types.js.map +0 -1
- package/dist/workflows/domain-workflows.d.ts +0 -8
- package/dist/workflows/domain-workflows.d.ts.map +0 -1
- package/dist/workflows/domain-workflows.js +0 -360
- 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).
|