@agentlee5/agent-skills 1.0.0

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 (182) hide show
  1. package/.leeway/config.json +133 -0
  2. package/LICENSE +21 -0
  3. package/LeeWay-Standards/LICENSE +21 -0
  4. package/LeeWay-Standards/README.md +324 -0
  5. package/LeeWay-Standards/examples/NexusButton.tsx +90 -0
  6. package/LeeWay-Standards/examples/example-agent.js +89 -0
  7. package/LeeWay-Standards/package.json +61 -0
  8. package/LeeWay-Standards/schemas/leeway-config.schema.json +81 -0
  9. package/LeeWay-Standards/schemas/leeway-header.schema.json +63 -0
  10. package/LeeWay-Standards/src/agents/discovery/architecture-map-agent.js +134 -0
  11. package/LeeWay-Standards/src/agents/discovery/docs-agent.js +126 -0
  12. package/LeeWay-Standards/src/agents/discovery/explain-agent.js +95 -0
  13. package/LeeWay-Standards/src/agents/discovery/intent-registry-agent.js +119 -0
  14. package/LeeWay-Standards/src/agents/discovery/schema-agent.js +116 -0
  15. package/LeeWay-Standards/src/agents/discovery/sitemap-agent.js +88 -0
  16. package/LeeWay-Standards/src/agents/governance/align-agent.js +155 -0
  17. package/LeeWay-Standards/src/agents/governance/assess-agent.js +161 -0
  18. package/LeeWay-Standards/src/agents/governance/audit-agent.js +185 -0
  19. package/LeeWay-Standards/src/agents/integrity/circular-dependency-agent.js +88 -0
  20. package/LeeWay-Standards/src/agents/integrity/dependency-graph-agent.js +107 -0
  21. package/LeeWay-Standards/src/agents/integrity/duplicate-logic-agent.js +108 -0
  22. package/LeeWay-Standards/src/agents/integrity/import-agent.js +83 -0
  23. package/LeeWay-Standards/src/agents/integrity/module-policy-agent.js +94 -0
  24. package/LeeWay-Standards/src/agents/integrity/refactor-scan-agent.js +113 -0
  25. package/LeeWay-Standards/src/agents/integrity/syntax-agent.js +84 -0
  26. package/LeeWay-Standards/src/agents/mcp/endpoint-agent.js +106 -0
  27. package/LeeWay-Standards/src/agents/mcp/env-agent.js +111 -0
  28. package/LeeWay-Standards/src/agents/mcp/health-agent-lite.js +119 -0
  29. package/LeeWay-Standards/src/agents/mcp/manifest-agent.js +87 -0
  30. package/LeeWay-Standards/src/agents/mcp/port-agent.js +125 -0
  31. package/LeeWay-Standards/src/agents/mcp/process-agent.js +124 -0
  32. package/LeeWay-Standards/src/agents/mcp/runtime-agent.js +108 -0
  33. package/LeeWay-Standards/src/agents/mcp/transport-agent.js +78 -0
  34. package/LeeWay-Standards/src/agents/orchestration/doctor-agent.js +149 -0
  35. package/LeeWay-Standards/src/agents/orchestration/memory-agent-lite.js +125 -0
  36. package/LeeWay-Standards/src/agents/orchestration/router-agent.js +110 -0
  37. package/LeeWay-Standards/src/agents/security/permission-agent.js +98 -0
  38. package/LeeWay-Standards/src/agents/security/policy-agent.js +100 -0
  39. package/LeeWay-Standards/src/agents/security/privacy-agent.js +83 -0
  40. package/LeeWay-Standards/src/agents/security/prompt-security-agent.js +103 -0
  41. package/LeeWay-Standards/src/agents/security/secret-scan-agent.js +108 -0
  42. package/LeeWay-Standards/src/agents/security/tool-access-agent.js +105 -0
  43. package/LeeWay-Standards/src/agents/standards/authority-agent.js +114 -0
  44. package/LeeWay-Standards/src/agents/standards/discovery-pipeline-agent.js +91 -0
  45. package/LeeWay-Standards/src/agents/standards/header-agent.js +120 -0
  46. package/LeeWay-Standards/src/agents/standards/placement-agent.js +96 -0
  47. package/LeeWay-Standards/src/agents/standards/region-agent.js +99 -0
  48. package/LeeWay-Standards/src/agents/standards/registry-agent.js +153 -0
  49. package/LeeWay-Standards/src/agents/standards/tag-agent.js +111 -0
  50. package/LeeWay-Standards/src/cli/leeway.js +225 -0
  51. package/LeeWay-Standards/src/core/compliance-scorer.js +168 -0
  52. package/LeeWay-Standards/src/core/compliance-scorer.test.js +121 -0
  53. package/LeeWay-Standards/src/core/header-parser.js +207 -0
  54. package/LeeWay-Standards/src/core/header-parser.test.js +198 -0
  55. package/LeeWay-Standards/src/core/region-classifier.js +137 -0
  56. package/LeeWay-Standards/src/core/region-classifier.test.js +100 -0
  57. package/LeeWay-Standards/src/core/tag-validator.js +139 -0
  58. package/LeeWay-Standards/src/core/tag-validator.test.js +109 -0
  59. package/LeeWay-Standards/src/index.js +83 -0
  60. package/README.md +217 -0
  61. package/agent-config.yaml +456 -0
  62. package/agentbage.png.png +0 -0
  63. package/bin/leeway-skills-badge.js +52 -0
  64. package/bin/leeway-skills-mcp.js +48 -0
  65. package/bin/leeway-skills.js +160 -0
  66. package/bin/leeway-standards.js +49 -0
  67. package/config/.skillsignore +63 -0
  68. package/config/skills-config.json +70 -0
  69. package/documents/AGENT_LEARNING_REFERENCE.md +329 -0
  70. package/documents/AGENT_LEE_INTEGRATION.md +534 -0
  71. package/documents/COMPLETE_SYSTEM_OVERVIEW.md +502 -0
  72. package/documents/COMPREHENSIVE_SKILL_INTEGRATION_PLAN.md +644 -0
  73. package/documents/DIRECTORY_MAP.md +323 -0
  74. package/documents/EXTENDING.md +514 -0
  75. package/documents/FILE_DIRECTORY_GUIDE.md +427 -0
  76. package/documents/LEEWAY_BADGE_INTEGRATION.md +76 -0
  77. package/documents/LEEWAY_IMPLEMENTATION_SUMMARY.md +384 -0
  78. package/documents/LEEWAY_INTEGRATION_GUIDE.md +414 -0
  79. package/documents/LEEWAY_NPM_SDK.md +66 -0
  80. package/documents/LEEWAY_QUICK_START.md +288 -0
  81. package/documents/LEEWAY_SKILLS_BRANDING.md +375 -0
  82. package/documents/LEEWAY_SKILLS_MCP_SUMMARY.md +593 -0
  83. package/documents/LEEWAY_STANDARDS_COMPLIANCE.md +361 -0
  84. package/documents/LEEWAY_UNIFIED_ARCHITECTURE.md +473 -0
  85. package/documents/LEEWAY_WORKFLOWS_QUICK_REFERENCE.md +307 -0
  86. package/documents/LEEWAY_WORKFLOWS_STRATEGIC_PLAN.md +515 -0
  87. package/documents/LIFELONG_LEARNING_LAYER.md +478 -0
  88. package/documents/MCP_ARCHITECTURE.md +683 -0
  89. package/documents/QUICK_REFERENCE.md +301 -0
  90. package/documents/SETUP.md +325 -0
  91. package/documents/SETUP_SUMMARY.md +413 -0
  92. package/documents/SKILL_ACQUISITION_EXECUTIVE_SUMMARY.md +373 -0
  93. package/documents/SKILL_ACQUISITION_IMPLEMENTATION.md +692 -0
  94. package/documents/SKILL_ACQUISITION_MANIFEST.md +404 -0
  95. package/documents/SKILL_ACQUISITION_QUICK_REFERENCE.md +349 -0
  96. package/documents/SKILL_WORKFLOW_COMPOSITION_MATRIX.md +537 -0
  97. package/documents/STRUCTURE.md +382 -0
  98. package/documents/SYSTEM_TRANSFORMATION_SUMMARY.md +560 -0
  99. package/documents/USAGE.md +390 -0
  100. package/documents/WORKFLOW_ACQUISITION_MANIFEST.md +576 -0
  101. package/documents/aiskills.txt +460 -0
  102. package/mcp-server/README.md +697 -0
  103. package/mcp-server/dist/badge-proof.d.ts +66 -0
  104. package/mcp-server/dist/badge-proof.d.ts.map +1 -0
  105. package/mcp-server/dist/badge-proof.js +324 -0
  106. package/mcp-server/dist/badge-proof.js.map +1 -0
  107. package/mcp-server/dist/index.d.ts +64 -0
  108. package/mcp-server/dist/index.d.ts.map +1 -0
  109. package/mcp-server/dist/index.js +263 -0
  110. package/mcp-server/dist/index.js.map +1 -0
  111. package/mcp-server/dist/install-badge-proof.d.ts +3 -0
  112. package/mcp-server/dist/install-badge-proof.d.ts.map +1 -0
  113. package/mcp-server/dist/install-badge-proof.js +109 -0
  114. package/mcp-server/dist/install-badge-proof.js.map +1 -0
  115. package/mcp-server/package.json +43 -0
  116. package/mcp-server/src/badge-proof.ts +469 -0
  117. package/mcp-server/src/index.ts +355 -0
  118. package/mcp-server/src/install-badge-proof.ts +132 -0
  119. package/mcp-server/tsconfig.json +22 -0
  120. package/package.json +84 -0
  121. package/scripts/init-leeway.js +217 -0
  122. package/scripts/leeway-agents/compliance-monitor.js +374 -0
  123. package/scripts/leeway-agents/header-injector.js +321 -0
  124. package/scripts/skill-integration-toolkit.py +319 -0
  125. package/scripts/skills-registry.json +1117 -0
  126. package/scripts/sync-skills.ps1 +275 -0
  127. package/scripts/verify-leeway-setup.js +249 -0
  128. package/scripts/workflow-integration-toolkit.py +522 -0
  129. package/sdk/application-installer.js +92 -0
  130. package/sdk/index.js +43 -0
  131. package/sdk/paths.js +167 -0
  132. package/skills/agent-autonomy/autonomous-conductor/SKILL.md +206 -0
  133. package/skills/agent-autonomy/full-stack-delivery/SKILL.md +206 -0
  134. package/skills/agent-orchestration/multi-agent-orchestration/SKILL.md +68 -0
  135. package/skills/agent-patterns/agent-design-patterns/SKILL.md +70 -0
  136. package/skills/ai-ml/llm-prompting/SKILL.md +71 -0
  137. package/skills/ai-ml/ml-model-development/SKILL.md +67 -0
  138. package/skills/ai-ml/multimodal-systems/SKILL.md +71 -0
  139. package/skills/ai-ml/retrieval-generation-fine-tuning/SKILL.md +71 -0
  140. package/skills/architecture/system-design/SKILL.md +67 -0
  141. package/skills/code-analysis/refactoring/SKILL.md +64 -0
  142. package/skills/code-analysis/security-vulnerability-scanning/SKILL.md +71 -0
  143. package/skills/code-analysis/static-analysis/SKILL.md +64 -0
  144. package/skills/code-generation/full-stack-application/SKILL.md +70 -0
  145. package/skills/code-generation/microservices-architecture/SKILL.md +71 -0
  146. package/skills/code-generation/python-codegen/SKILL.md +64 -0
  147. package/skills/code-generation/typescript-codegen/SKILL.md +64 -0
  148. package/skills/data-analysis/advanced-analytics/SKILL.md +71 -0
  149. package/skills/data-analysis/pandas-analysis/SKILL.md +66 -0
  150. package/skills/database-design/database-design-optimization/SKILL.md +70 -0
  151. package/skills/debugging/javascript-debugging/SKILL.md +67 -0
  152. package/skills/debugging/python-debugging/SKILL.md +67 -0
  153. package/skills/devops/dockerfile-creation/SKILL.md +64 -0
  154. package/skills/devops/kubernetes-deployment/SKILL.md +65 -0
  155. package/skills/documentation/api-documentation/SKILL.md +67 -0
  156. package/skills/error-handling/resilience-patterns/SKILL.md +70 -0
  157. package/skills/git-workflow/git-collaboration/SKILL.md +67 -0
  158. package/skills/infrastructure/cicd-pipelines/SKILL.md +70 -0
  159. package/skills/infrastructure/infrastructure-as-code/SKILL.md +70 -0
  160. package/skills/observability/monitoring-and-observability/SKILL.md +70 -0
  161. package/skills/performance-optimization/performance-engineering/SKILL.md +70 -0
  162. package/skills/prompt-optimization/prompt-engineering-advanced/SKILL.md +70 -0
  163. package/skills/quality-assurance/deployment-validator/SKILL.md +382 -0
  164. package/skills/quality-assurance/web-security-sweep/SKILL.md +320 -0
  165. package/skills/rag-knowledge/rag-systems/SKILL.md +70 -0
  166. package/skills/research/knowledge-synthesis/SKILL.md +71 -0
  167. package/skills/security/authentication-authorization/SKILL.md +71 -0
  168. package/skills/security/code-security/SKILL.md +66 -0
  169. package/skills/security/secure-architecture/SKILL.md +71 -0
  170. package/skills/self-optimization/dev-loop-optimizer/SKILL.md +344 -0
  171. package/skills/self-optimization/memory-learning/SKILL.md +335 -0
  172. package/skills/self-optimization/runtime-self-profiling/SKILL.md +250 -0
  173. package/skills/testing/advanced-testing-strategies/SKILL.md +71 -0
  174. package/skills/testing/integration-testing/SKILL.md +66 -0
  175. package/skills/testing/load-testing-capacity/SKILL.md +71 -0
  176. package/skills/testing/unit-testing/SKILL.md +66 -0
  177. package/skills/tool-integration/custom-tool-creation/SKILL.md +70 -0
  178. package/skills/web-development/advanced-frontend-patterns/SKILL.md +71 -0
  179. package/skills/web-development/api-design/SKILL.md +71 -0
  180. package/skills/web-development/css-styling/SKILL.md +67 -0
  181. package/skills/web-development/react-development/SKILL.md +79 -0
  182. package/skills/workflow-composition/workflow-orchestration/SKILL.md +70 -0
package/sdk/paths.js ADDED
@@ -0,0 +1,167 @@
1
+ /*
2
+ LEEWAY HEADER — DO NOT REMOVE
3
+
4
+ REGION: LEEWAY.SKILLS.SDK
5
+ TAG: LEEWAY.SKILLS.SDK.PATHS
6
+
7
+ COLOR_ONION_HEX:
8
+ NEON=#39FF14
9
+ FLUO=#0DFF94
10
+ PASTEL=#C7FFD8
11
+
12
+ ICON_ASCII:
13
+ family=lucide
14
+ glyph=folder-tree
15
+
16
+ 5WH:
17
+ WHAT = Shared package path and metadata helpers for the npm-distributed Leeway Skills application
18
+ WHY = Consumers need stable access to packaged assets, docs, registry files, and runtime entrypoints
19
+ WHO = Leeway Industries (By Leonard Jerome Lee)
20
+ WHERE = sdk/paths.js
21
+ WHEN = 2026
22
+ HOW = Resolves absolute paths from the installed package root and exposes package summary helpers
23
+
24
+ AGENTS:
25
+ DISCOVER
26
+ INTROSPECT
27
+
28
+ LICENSE:
29
+ MIT
30
+ */
31
+
32
+ import fs from "node:fs/promises";
33
+ import path from "node:path";
34
+ import { fileURLToPath } from "node:url";
35
+
36
+ const __filename = fileURLToPath(import.meta.url);
37
+ const __dirname = path.dirname(__filename);
38
+ const PACKAGE_ROOT = path.resolve(__dirname, "..");
39
+
40
+ export function getPackageRoot() {
41
+ return PACKAGE_ROOT;
42
+ }
43
+
44
+ export function getSkillsRoot() {
45
+ return path.join(PACKAGE_ROOT, "skills");
46
+ }
47
+
48
+ export function getDocumentsRoot() {
49
+ return path.join(PACKAGE_ROOT, "documents");
50
+ }
51
+
52
+ export function getScriptsRoot() {
53
+ return path.join(PACKAGE_ROOT, "scripts");
54
+ }
55
+
56
+ export function getConfigRoot() {
57
+ return path.join(PACKAGE_ROOT, "config");
58
+ }
59
+
60
+ export function getRegistryPath() {
61
+ return path.join(getScriptsRoot(), "skills-registry.json");
62
+ }
63
+
64
+ export function getLeewayConfigPath() {
65
+ return path.join(PACKAGE_ROOT, ".leeway", "config.json");
66
+ }
67
+
68
+ export function getBadgePath() {
69
+ return path.join(PACKAGE_ROOT, "agentbage.png.png");
70
+ }
71
+
72
+ export function getAgentConfigPath() {
73
+ return path.join(PACKAGE_ROOT, "agent-config.yaml");
74
+ }
75
+
76
+ export function getMcpServerEntryPath() {
77
+ return path.join(PACKAGE_ROOT, "mcp-server", "dist", "index.js");
78
+ }
79
+
80
+ export function getMcpBadgeInstallerPath() {
81
+ return path.join(PACKAGE_ROOT, "mcp-server", "dist", "install-badge-proof.js");
82
+ }
83
+
84
+ export function getStandardsCliPath() {
85
+ return path.join(PACKAGE_ROOT, "LeeWay-Standards", "src", "cli", "leeway.js");
86
+ }
87
+
88
+ export function getPackagedPaths() {
89
+ return {
90
+ packageRoot: getPackageRoot(),
91
+ skillsRoot: getSkillsRoot(),
92
+ documentsRoot: getDocumentsRoot(),
93
+ scriptsRoot: getScriptsRoot(),
94
+ configRoot: getConfigRoot(),
95
+ registryPath: getRegistryPath(),
96
+ leewayConfigPath: getLeewayConfigPath(),
97
+ badgePath: getBadgePath(),
98
+ agentConfigPath: getAgentConfigPath(),
99
+ mcpServerEntryPath: getMcpServerEntryPath(),
100
+ mcpBadgeInstallerPath: getMcpBadgeInstallerPath(),
101
+ standardsCliPath: getStandardsCliPath(),
102
+ };
103
+ }
104
+
105
+ export async function readPackageManifest() {
106
+ const manifestPath = path.join(PACKAGE_ROOT, "package.json");
107
+ const content = await fs.readFile(manifestPath, "utf-8");
108
+ return JSON.parse(content);
109
+ }
110
+
111
+ export async function readSkillsRegistry() {
112
+ const content = await fs.readFile(getRegistryPath(), "utf-8");
113
+ return JSON.parse(content);
114
+ }
115
+
116
+ export async function scanPackagedSkills() {
117
+ const categories = await fs.readdir(getSkillsRoot(), { withFileTypes: true });
118
+ let installedSkills = 0;
119
+ let installedCategories = 0;
120
+
121
+ for (const category of categories) {
122
+ if (!category.isDirectory()) {
123
+ continue;
124
+ }
125
+
126
+ installedCategories += 1;
127
+ const categoryPath = path.join(getSkillsRoot(), category.name);
128
+ const skillEntries = await fs.readdir(categoryPath, { withFileTypes: true });
129
+
130
+ for (const skillEntry of skillEntries) {
131
+ if (!skillEntry.isDirectory()) {
132
+ continue;
133
+ }
134
+
135
+ try {
136
+ await fs.access(path.join(categoryPath, skillEntry.name, "SKILL.md"));
137
+ installedSkills += 1;
138
+ } catch {
139
+ // Ignore directories that are not valid skills.
140
+ }
141
+ }
142
+ }
143
+
144
+ return {
145
+ installedSkills,
146
+ installedCategories,
147
+ };
148
+ }
149
+
150
+ export async function getPackageSummary() {
151
+ const [manifest, registry, installed] = await Promise.all([
152
+ readPackageManifest(),
153
+ readSkillsRegistry(),
154
+ scanPackagedSkills(),
155
+ ]);
156
+
157
+ return {
158
+ name: manifest.name ?? "unknown",
159
+ version: manifest.version ?? "unknown",
160
+ activeSkills: registry.totalSkills ?? 0,
161
+ activeCategories:
162
+ registry.totalCategories ?? registry.categories?.length ?? 0,
163
+ installedSkills: installed.installedSkills,
164
+ installedCategories: installed.installedCategories,
165
+ paths: getPackagedPaths(),
166
+ };
167
+ }
@@ -0,0 +1,206 @@
1
+ /*
2
+ LEEWAY HEADER — DO NOT REMOVE
3
+
4
+ REGION: AI.AGENT.AUTONOMY
5
+ TAG: AI.AGENT.AUTONOMY.AUTONOMOUS_CONDUCTOR
6
+
7
+ COLOR_ONION_HEX:
8
+ NEON=#39FF14
9
+ FLUO=#0DFF94
10
+ PASTEL=#E8F5E9
11
+
12
+ ICON_ASCII:
13
+ family=lucide
14
+ glyph=zap
15
+
16
+ 5WH:
17
+ WHAT = autonomous conductor skill for Leeway-compliant AI systems
18
+ WHY = Provides capabilities for agent-autonomy within the AIskills ecosystem
19
+ WHO = Leeway Industries (By Leonard Jerome Lee)
20
+ WHERE = skills/agent-autonomy/autonomous-conductor/SKILL.md
21
+ WHEN = 2026
22
+ HOW = Leeway-governed skill.md definition with structured capabilities and tags
23
+
24
+ AGENTS:
25
+ ASSESS
26
+ AUDIT
27
+
28
+ LICENSE:
29
+ MIT
30
+ */
31
+
32
+ # Autonomous Project Conductor
33
+
34
+ **Expert in**: Orchestrating multiple specialized skills (engineering, research, deployment, QA) to deliver complex projects autonomously. Maintains a central goal, selects relevant skills, coordinates sub-agents, and ensures projects reach completion without human micromanagement.
35
+
36
+ **Role**: Technical Lead / Project Orchestrator
37
+
38
+ ## Mission
39
+
40
+ You are an autonomous conductor responsible for taking a high-level business objective, breaking it into sub-goals, coordinating specialized agents (app delivery, research, infrastructure, QA), and ensuring delivery without waiting for human decisions at each step.
41
+
42
+ ## Operating Principles
43
+
44
+ 1. **Break complex goals into sub-projects** that can be owned by specialized skills/agents.
45
+ 2. **Maintain a central backlog**: track which projects are pending, active, blocked, or complete.
46
+ 3. **Choose the right skill for each sub-goal**: don't route everything to the same agent; use specialists.
47
+ 4. **Keep sub-agents independent** but synchronized: they update a shared state log (`conductor_log.md`) so you can resume.
48
+ 5. **Make small decisions autonomously**; only escalate when truly ambiguous.
49
+ 6. **Bundle work into coherent hand-offs**: don't interrupt a working agent to switch context.
50
+
51
+ ## Workflow
52
+
53
+ ### Setup Phase
54
+
55
+ 1. **Accept the business objective** (e.g., "build a SaaS app for scheduling").
56
+ 2. **Restate it** with constraints, timeline, and success criteria.
57
+ 3. **Decompose into sub-projects**:
58
+ - **App Delivery**: core SaaS application.
59
+ - **Research**: competitive analysis, tech landscape, user needs validation.
60
+ - **Infrastructure**: deployment pipeline, monitoring, alerting setup.
61
+ - **Security**: threat model, compliance checklist, penetration testing (if applicable).
62
+ - **QA**: test strategy, automation, performance baselines.
63
+ 4. **Create `conductor_log.md`** with the decomposition and initial project backlog.
64
+ 5. **Assign lead skills** to each sub-project (e.g., full-stack-delivery for App).
65
+
66
+ ### Execution Phase
67
+
68
+ **For each active sub-project:**
69
+
70
+ 1. **Check state**: read the skill's project log (`project_log.md` in each sub-project directory).
71
+ 2. **Assess progress**:
72
+ - Is the skill on track? Blockers? Does it need context from another project?
73
+ 3. **Coordinate handoffs**:
74
+ - If App Delivery discovers "we need an API gateway", add that to Infrastructure's backlog.
75
+ - If Research finds "competitors use Redis", note it in the App Delivery design doc.
76
+ 4. **Unblock when possible**:
77
+ - If App is waiting on Infrastructure, ask Infrastructure to create a temporary solution.
78
+ - Log the workaround in `conductor_log.md`.
79
+ 5. **Check sub-project completion criteria**:
80
+ - App Delivery: passes quality checklist, runbooks written.
81
+ - Research: report drafted, findings fed to App Delivery.
82
+ - Infrastructure: deployment scripts tested, env configs documented.
83
+ 6. **Update conductor log** with status, dependencies resolved, and next focus.
84
+
85
+ ### Synchronization
86
+
87
+ Maintain `conductor_log.md` with sections:
88
+
89
+ ```markdown
90
+ # Conductor Log – [Project Name]
91
+
92
+ ## Project Overview
93
+
94
+ - **Objective**: [Business goal]
95
+ - **Start Date**: [Date]
96
+ - **Target Completion**: [Date]
97
+ - **Status**: In Progress (M2 of 5)
98
+
99
+ ## Sub-Projects Status
100
+
101
+ | Sub-Project | Status | Owner Skill | Latest Update | Blockers |
102
+ | -------------- | ----------- | -------------------- | ------------------ | ------------------------- |
103
+ | App Delivery | In Progress | full-stack-delivery | core auth | none |
104
+ | Research | Queued | knowledge-synthesis | pending | awaiting app architecture |
105
+ | Infrastructure | Blocked | cicd-pipelines | terraform skeleton | needs app API routes |
106
+ | Security | Queued | secure-architecture | backlog created | none |
107
+ | QA | Queued | deployment-validator | test plan draft | needs app ready |
108
+
109
+ ## Dependency Graph
110
+
111
+ - App Delivery → (informs) → Infrastructure (API routes)
112
+ - App Delivery → (informs) → QA (feature list)
113
+ - Research → (informs) → App Delivery (market findings)
114
+
115
+ ## Log Entries
116
+
117
+ ### 2026-03-15
118
+
119
+ - Spun up App Delivery sub-project; started project-contract.md
120
+ - Routed Research to knowledge-synthesis skill; began competitive analysis
121
+ - Infrastructure to create temporary Heroku config for demo deployment
122
+
123
+ ### 2026-03-14
124
+
125
+ - Resolved blocker: API keys for external service obtained; App Delivery unblocked
126
+
127
+ ## Decisions
128
+
129
+ - _Decision_: Use Next.js instead of vanilla React (rationale: SEO + simpler deployment)
130
+ - Decision Log: `projects/app-delivery/decisions_log.md`
131
+
132
+ ## Upcoming Milestones
133
+
134
+ - M3: Integration testing (App, QA skills)
135
+ - M4: Performance baseline (QA, Infrastructure skills)
136
+ - M5: Production launch (App, Infrastructure, Security skills)
137
+ ```
138
+
139
+ ### Completion Phase
140
+
141
+ 1. **Gather final reports from each skill**:
142
+ - App Delivery: user-facing features working, tests passing.
143
+ - Infrastructure: deployment tested, monitoring configured.
144
+ - QA: performance baseline, security findings reviewed and addressed.
145
+ - Security: compliance checklist signed off.
146
+ - Research: findings documented, fed into decisions.
147
+
148
+ 2. **Produce final summary**:
149
+ - Combined architecture overview.
150
+ - Deployment and operations runbook.
151
+ - Backlog of future work.
152
+
153
+ 3. **Transition**: hand off to maintenance/continuation team with all logs and decisions.
154
+
155
+ ## Skill Coordination Rules
156
+
157
+ | Skill | Typical Phases | Inputs | Outputs | Typical Duration |
158
+ | ---------------------- | ------------------------------------ | -------------------------------------------- | --------------------------------------- | ---------------- |
159
+ | `full-stack-delivery` | Design, Implementation, Testing | Requirements, tech stack, constraints | Working app, design doc, tests | Weeks |
160
+ | `knowledge-synthesis` | Parallel with Delivery | Market, competitive landscape, user insights | Market report, feature recommendations | Week 1 |
161
+ | `infrastructure` | Parallel with Delivery (mid-to-late) | App architecture, scaling needs | Terraform, CI/CD, monitoring setup | Weeks 2+ |
162
+ | `secure-architecture` | Late in Delivery, before launch | Feature list, data flows, compliance needs | Threat model, security checklist, fixes | Week N-1 |
163
+ | `deployment-validator` | Pre-launch | Build scripts, configs, app artifacts | Validation report, performance baseline | Day N |
164
+
165
+ ## Decision-Making
166
+
167
+ **Autonomous decisions** (conductor decides):
168
+
169
+ - Reordering tasks within a sub-project.
170
+ - Creating workarounds to unblock parallel work.
171
+ - Adjusting timeline if a skill discovers scope changes.
172
+
173
+ **Escalated decisions** (conductor asks for clarification):
174
+
175
+ - Scope change that shifts the core objective.
176
+ - Resource constraints (time, budget, team availability).
177
+ - Conflicting requirements (e.g., "faster" vs. "more secure"—tradeoff analysis).
178
+
179
+ Escalation note format:
180
+
181
+ ```
182
+ ## Escalation: [Issue]
183
+
184
+ **Problem**: [What changed / what's unclear?]
185
+
186
+ **Option A**: [Path, implications, timeline]
187
+ **Option B**: [Alternative path, implications, timeline]
188
+ **Recommendation**: [Which option, and why]
189
+
190
+ **Impact if deferred**: [What blocks if not resolved now?]
191
+ ```
192
+
193
+ ## Tags
194
+
195
+ orchestration, autonomy, coordination, multi-agent, project-leadership, dependency-management, goal-ownership, scaling
196
+
197
+ ## Capabilities
198
+
199
+ - Decomposing complex goals into specialized sub-projects
200
+ - Coordinating multiple agents and skills in parallel
201
+ - Managing dependencies between projects
202
+ - Unblocking work autonomously through workarounds
203
+ - Synthesizing final deliverables from multiple sources
204
+ - Maintaining central state across distributed work
205
+ - Escalating only genuinely ambiguous decisions
206
+ - Tracking progress and timeline across the project lifecycle
@@ -0,0 +1,206 @@
1
+ /*
2
+ LEEWAY HEADER — DO NOT REMOVE
3
+
4
+ REGION: AI.AGENT.AUTONOMY
5
+ TAG: AI.AGENT.AUTONOMY.FULL_STACK_DELIVERY
6
+
7
+ COLOR_ONION_HEX:
8
+ NEON=#39FF14
9
+ FLUO=#0DFF94
10
+ PASTEL=#E8F5E9
11
+
12
+ ICON_ASCII:
13
+ family=lucide
14
+ glyph=zap
15
+
16
+ 5WH:
17
+ WHAT = full stack delivery skill for Leeway-compliant AI systems
18
+ WHY = Provides capabilities for agent-autonomy within the AIskills ecosystem
19
+ WHO = Leeway Industries (By Leonard Jerome Lee)
20
+ WHERE = skills/agent-autonomy/full-stack-delivery/SKILL.md
21
+ WHEN = 2026
22
+ HOW = Leeway-governed skill.md definition with structured capabilities and tags
23
+
24
+ AGENTS:
25
+ ASSESS
26
+ AUDIT
27
+
28
+ LICENSE:
29
+ MIT
30
+ */
31
+
32
+ # Full-Stack Application Delivery (AI Employee)
33
+
34
+ **Expert in**: Building complete, production-ready applications from business goals with autonomous planning, execution, and quality assurance. Owns projects end-to-end with no human guidance beyond initial requirements.
35
+
36
+ **Role**: Senior Full-Stack Engineer
37
+
38
+ ## Mission
39
+
40
+ You behave as a senior full-stack engineer responsible for delivering a working application from a business goal through design, implementation, testing, security hardening, and deployment documentation—with persistent state across sessions and self-directed execution.
41
+
42
+ ## Operating Principles
43
+
44
+ 1. **Own the goal end-to-end** without micromanagement; work in clear, measurable milestones.
45
+ 2. **Maintain explicit state**: keep a live TODO/backlog, decision log, and project summary; update them as you learn.
46
+ 3. **Never skip quality gates**: architecture review, tests, security checklist, and monitoring setup are non-negotiable.
47
+ 4. **Use memory to persist context**: resume work across sessions; pull lessons from previous projects.
48
+ 5. **Escalate only when truly blocked**: try alternatives, document assumptions, and prepare a clear escalation summary.
49
+
50
+ ## Workflow
51
+
52
+ ### Phase 1 – Understand & Frame (Session 1)
53
+
54
+ 1. **Restate the goal** in your own words with constraints, success criteria, and non-goals clearly stated.
55
+ 2. **Identify critical unknowns**:
56
+ - Platform(s) (web, mobile, API, hybrid)?
57
+ - Tech stack preferences (React/Next, Flutter, FastAPI)?
58
+ - Non-functional requirements (scale, latency, security, compliance)?
59
+ - Deployment target (cloud, self-hosted, serverless)?
60
+ 3. **If information is missing**, make a reasonable assumption, log it in `decisions_log.md`, and proceed.
61
+ 4. **Output**:
62
+ - `project_contract.md`: one-page statement of problem, success criteria, constraints.
63
+ - `decisions_log.md`: opened; first entry logs assumptions made.
64
+
65
+ ### Phase 2 – Design & Plan (Session 1–2)
66
+
67
+ 1. **Architecture sketch**:
68
+ - High-level components (frontend, backend, database, external services).
69
+ - Data flows (user interactions → API → persistence → external service).
70
+ - Error/failure paths (what breaks? how do we recover?).
71
+ 2. **Security & quality baseline**:
72
+ - List default practices you will apply (auth, validation, logging, rate limiting, secrets management).
73
+ - Identify early security constraints (PII handling, compliance, API authentication).
74
+ 3. **Milestones & tasks**:
75
+ - M1: Project scaffolding, core data model, and basic API.
76
+ - M2: Frontend scaffolding and feature A.
77
+ - M3: Feature B, notification/integration.
78
+ - M4: Testing, security sweep, performance baseline.
79
+ - M5: Deployment setup and documentation.
80
+ 4. **Output**:
81
+ - `design_doc.md`: architecture, data flow diagrams (ASCII or textual), component responsibilities.
82
+ - `project_plan.md`: milestones, task breakdown, dependencies, estimated scope.
83
+ - `project_log.md`: daily log of progress, decisions, and discoveries.
84
+
85
+ ### Phase 3 – Execute Iteratively (Sessions 2+)
86
+
87
+ For each milestone:
88
+
89
+ 1. **Pick the next task** from the backlog in `project_plan.md`.
90
+ 2. **Gather context**:
91
+ - Inspect existing repo structure and files.
92
+ - Review git history and prior decisions in `decisions_log.md`.
93
+ - Query tools (filesystem, git, shell, http) to understand constraints.
94
+ 3. **Plan concretely**:
95
+ - What files are created/modified?
96
+ - What test cases are written?
97
+ - What CLI/API calls are made?
98
+ - Log the plan in `project_log.md` before acting.
99
+ 4. **Execute**:
100
+ - Apply changes using filesystem, git, and shell tools.
101
+ - Run linters, type checkers, and tests via shell.
102
+ - Review changes via git diff.
103
+ 5. **Evaluate**:
104
+ - If tests fail or behavior is wrong: debug, understand the root cause, log finding, and iterate.
105
+ - If tests pass: commit with a clear message referencing the task.
106
+ - Update `project_log.md` with result and any new discoveries.
107
+ 6. **Log learnings**:
108
+ - Record tradeoffs ("chose SQLite over Postgres because…").
109
+ - Note edge cases discovered ("users can't logout if session persists…").
110
+ - Append to `patterns_log.md` if the insight would help future projects.
111
+
112
+ ### Phase 4 – Harden & Document (Session N-1)
113
+
114
+ 1. **Run quality checklist**:
115
+ - [ ] Core user flows have tests (unit or integration).
116
+ - [ ] Basic error handling is present (no unhandled exceptions).
117
+ - [ ] Security practices applied (auth, validation, secrets not in code).
118
+ - [ ] Logging/observability hooks are in place.
119
+ - [ ] Documentation exists (README, design doc, deployment guide).
120
+ - [ ] Runbook written (common failures and recovery steps).
121
+ 2. **If gaps exist**, create tasks to close them.
122
+ 3. **Produce**:
123
+ - `README.md`: how to build, run, test, deploy locally.
124
+ - `DEPLOYMENT.md`: production deployment steps, env vars, scaling.
125
+ - `RUNBOOK.md`: common issues and fixes.
126
+ - `decisions_log.md`: finalized with all design choices and rationale.
127
+
128
+ ### Phase 5 – Review & Transition (Session N)
129
+
130
+ 1. **Summary for handoff**:
131
+ - Current state: what's working, what's not, known limitations.
132
+ - Backlog: unfinished work, nice-to-haves.
133
+ - Next steps: what a maintainer or continuation session should do.
134
+ 2. **Archive logs** and ensure they're accessible for future sessions.
135
+
136
+ ## Error Handling
137
+
138
+ | Scenario | Action |
139
+ | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
140
+ | Tool fails (git, shell, HTTP) | Retry with adjusted parameters; if persists, log and try alternative. Log in `project_log.md`. |
141
+ | Test failure | Debug immediately; identify root cause before moving on. If unfixable, escalate. |
142
+ | Ambiguity in requirements | Choose reasonable default, log assumption with confidence level, proceed. |
143
+ | Blocker (missing library, API key, etc.) | Prepare escalation summary: problem statement, options, and tradeoffs. Do not silently skip. |
144
+ | Performance/security concern discovered mid-task | Stop, raise concern in `decisions_log.md`, discuss tradeoff, and decide whether to fix now or defer. |
145
+
146
+ ## Memory & State Files
147
+
148
+ Always maintain:
149
+
150
+ - `project_contract.md`: immutable problem statement (updated only if goals change formally).
151
+ - `design_doc.md`: architecture, component graph, key flows.
152
+ - `project_plan.md`: milestone breakdown and task backlog, status of each task.
153
+ - `project_log.md`: dated entries with progress, decisions, and key discoveries.
154
+ - `decisions_log.md`: why each major architectural or technical choice was made.
155
+ - `patterns_log.md`: cross-project lessons (created once, appended across projects).
156
+
157
+ ## Status Report Format
158
+
159
+ When asked "What's the status?", respond with:
160
+
161
+ ```
162
+ ## Project: [Name]
163
+ **Current Milestone**: M2 (58% complete)
164
+
165
+ **Latest Work** (last 3 days):
166
+ - Completed: API endpoint scaffolding, database schema migration
167
+ - In Progress: Frontend login screen, test fixtures
168
+ - Blocked: None currently
169
+
170
+ **Key Risks**:
171
+ - Performance: pagination not yet optimized; will address in M4
172
+ - Security: rate limiting not yet added; planned for M4 security sweep
173
+
174
+ **Next 3 Tasks**:
175
+ 1. Complete login flow tests
176
+ 2. Implement password reset email integration
177
+ 3. Deploy test environment
178
+
179
+ **Log Reference**: `project_log.md` (2026-03-15 onward)
180
+ ```
181
+
182
+ ## Quality Gates Checklist
183
+
184
+ Before declaring a milestone complete:
185
+
186
+ - [ ] All milestone tasks marked done in `project_plan.md`
187
+ - [ ] Tests run and pass
188
+ - [ ] Code reviewed against style guide (linting passes)
189
+ - [ ] No new TODOs or FIXMEs without corresponding backlog items
190
+ - [ ] Changes logged in `project_log.md`
191
+ - [ ] Decisions documented in `decisions_log.md` if architectural
192
+
193
+ ## Tags
194
+
195
+ autonomy, planning, execution, full-stack, engineering, testing, documentation, persistence, quality-gates, goal-ownership
196
+
197
+ ## Capabilities
198
+
199
+ - Breaking business goals into milestones and tasks
200
+ - Designing full-stack systems (frontend, API, database, integrations)
201
+ - Implementing applications with test-driven development
202
+ - Running security and quality checklists
203
+ - Maintaining project state across sessions via logs and backlogs
204
+ - Debugging failed tests and tools gracefully
205
+ - Documenting architecture, deployment, operations, and runbooks
206
+ - Escalating blockers with clear context and options
@@ -0,0 +1,68 @@
1
+ /*
2
+ LEEWAY HEADER — DO NOT REMOVE
3
+
4
+ REGION: AI.AGENT.ORCHESTRATION
5
+ TAG: AI.AGENT.ORCHESTRATION.MULTI_AGENT_ORCHESTRATION
6
+
7
+ COLOR_ONION_HEX:
8
+ NEON=#FF00FF
9
+ FLUO=#FF1493
10
+ PASTEL=#E8F5E9
11
+
12
+ ICON_ASCII:
13
+ family=lucide
14
+ glyph=zap
15
+
16
+ 5WH:
17
+ WHAT = multi agent orchestration skill for Leeway-compliant AI systems
18
+ WHY = Provides capabilities for agent-orchestration within the AIskills ecosystem
19
+ WHO = Leeway Industries (By Leonard Jerome Lee)
20
+ WHERE = skills/agent-orchestration/multi-agent-orchestration/SKILL.md
21
+ WHEN = 2026
22
+ HOW = Leeway-governed skill.md definition with structured capabilities and tags
23
+
24
+ AGENTS:
25
+ ASSESS
26
+ AUDIT
27
+
28
+ LICENSE:
29
+ MIT
30
+ */
31
+
32
+ # Multi-Agent Orchestration
33
+
34
+ **Expert in**: Coordinating multiple AI agents to work together on complex tasks through message passing, state management, and goal decomposition.
35
+
36
+ ## Capabilities
37
+
38
+ - Design multi-agent architectures and communication patterns
39
+ - Implement agent message passing and state synchronization
40
+ - Coordinate parallel agent execution
41
+ - Handle agent failures and retry logic
42
+ - Manage shared resources and context between agents
43
+ - Implement agent discovery and dynamic team formation
44
+ - Create hierarchical agent structures (orchestrator pattern)
45
+ - Log and trace multi-agent interactions
46
+
47
+ ## Use this skill when:
48
+
49
+ - Building systems where multiple agents handle different subtasks
50
+ - Need agents to collaborate on complex problems
51
+ - Distributing workload across specialized agents
52
+ - Creating hierarchical agent systems (supervisors, workers)
53
+ - Implementing fault tolerance across agent networks
54
+ - Building real-time agent collaboration systems
55
+
56
+ ## Key techniques
57
+
58
+ - Message queues (RabbitMQ, Redis) for inter-agent communication
59
+ - State machines for agent coordination
60
+ - Pub/sub patterns for agent events
61
+ - Orchestrator/choreographer patterns
62
+ - Agent conversation flows and role-based messaging
63
+ - Timeout and retry strategies
64
+ - Transaction-like patterns for multi-agent operations
65
+
66
+ ## Tags
67
+
68
+ `agents` `orchestration` `multi-agent` `coordination` `message-passing` `distributed`