feat: Add Copilot instruction creator

Co-authored-by: benji <benji@codepros.org>

Author: cursoragent

cli/deps/deps_test.go

@@ -205,7 +205,7 @@ func TestDepsValidateCommand_DetectsCycle(t *testing.T) {
 
 // CANARY: REQ=CBIN-147; FEATURE="DepsParentCommand"; ASPECT=CLI; STATUS=TESTED; TEST=TestDepsParentCommand; UPDATED=2025-10-18
 func TestDepsParentCommand(t *testing.T) {
-	cmd := createDepsCommand()
+	cmd := CreateDepsCommand()
 
 	assert.NotNil(t, cmd)
 	assert.Equal(t, "deps", cmd.Use)

cli/migrate/migrate_test.go

@@ -10,12 +10,18 @@ package migrate
 import (
 	"os"
 	"path/filepath"
+	"strings"
 	"testing"
 
 	"go.devnw.com/canary/internal/migrate"
 	"go.devnw.com/canary/internal/storage"
 )
 
+// Helper function for string containment checks
+func contains(s, substr string) bool {
+	return strings.Contains(s, substr)
+}
+
 // TestCANARY_CBIN_145_CLI_OrphanDetection verifies detection of orphaned requirements
 func TestCANARY_CBIN_145_CLI_OrphanDetection(t *testing.T) {
 	tmpDir := t.TempDir()

cli/project/copilot.go

@@ -0,0 +1,89 @@
+// Copyright (c) 2025 by Developer Network.
+//
+// For more details, see the LICENSE file in the root directory of this
+// source code repository or contact Developer Network at info@devnw.com.
+
+package project
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"text/template"
+
+	"go.devnw.com/canary/cli/internal/utils"
+)
+
+// CANARY: REQ=CBIN-148; FEATURE="CopilotInstructionCreator"; ASPECT=CLI; STATUS=BENCHED; TEST=TestCreateCopilotInstructions; BENCH=BenchmarkCreateCopilotInstructions; UPDATED=2025-10-19
+// createCopilotInstructions generates GitHub Copilot instruction files for the project
+func createCopilotInstructions(projectPath, projectKey string) error {
+	instructionsDir := filepath.Join(projectPath, ".github", "instructions")
+
+	// Create .github/instructions/ directory structure
+	if err := os.MkdirAll(instructionsDir, 0755); err != nil {
+		return fmt.Errorf("create .github/instructions: %w", err)
+	}
+
+	// Define instruction files to create
+	instructionFiles := map[string]string{
+		// Repository-wide instruction
+		"repository.md": "base/copilot/repository.md",
+
+		// Path-specific instructions (nested directories)
+		".canary/specs/instruction.md": "base/copilot/specs.md",
+		".canary/instruction.md":       "base/copilot/canary.md",
+		"tests/instruction.md":         "base/copilot/tests.md",
+	}
+
+	// Template data for variable substitution
+	type TemplateData struct {
+		ProjectKey string
+	}
+	data := TemplateData{ProjectKey: projectKey}
+
+	for targetPath, templatePath := range instructionFiles {
+		fullTargetPath := filepath.Join(instructionsDir, targetPath)
+
+		// Check if file already exists (preserve user customizations)
+		if _, err := os.Stat(fullTargetPath); err == nil {
+			// Silently skip existing files to avoid noise in tests
+			continue
+		}
+
+		// Create parent directories for path-specific instructions
+		if err := os.MkdirAll(filepath.Dir(fullTargetPath), 0755); err != nil {
+			return fmt.Errorf("create directory for %s: %w", targetPath, err)
+		}
+
+		// Read template from embedded filesystem
+		templateContent, err := utils.ReadEmbeddedFile(templatePath)
+		if err != nil {
+			return fmt.Errorf("read template %s: %w", templatePath, err)
+		}
+
+		// Parse and execute template
+		tmpl, err := template.New(targetPath).Parse(string(templateContent))
+		if err != nil {
+			return fmt.Errorf("parse template %s: %w", templatePath, err)
+		}
+
+		// Write to file
+		outFile, err := os.Create(fullTargetPath)
+		if err != nil {
+			return fmt.Errorf("create file %s: %w", fullTargetPath, err)
+		}
+
+		if err := tmpl.Execute(outFile, data); err != nil {
+			outFile.Close()
+			return fmt.Errorf("execute template %s: %w", templatePath, err)
+		}
+		outFile.Close()
+	}
+
+	return nil
+}
+
+// readEmbeddedFile is a wrapper around utils.ReadEmbeddedFile for testing
+func readEmbeddedFile(path string) ([]byte, error) {
+	return utils.ReadEmbeddedFile(path)
+}

tools/canary/internal/tools/canary/testdata/updatestale/test.go

@@ -1,5 +1,5 @@
 package test
-// CANARY: REQ=CBIN-001; FEATURE="StaleToken"; ASPECT=API; STATUS=TESTED; TEST=Test1; UPDATED=2025-10-30
+// CANARY: REQ=CBIN-001; FEATURE="StaleToken"; ASPECT=API; STATUS=TESTED; TEST=Test1; UPDATED=2025-11-01
 // CANARY: REQ=CBIN-002; FEATURE="FreshToken"; ASPECT=CLI; STATUS=TESTED; TEST=Test2; UPDATED=2025-10-15
 // CANARY: REQ=CBIN-003; FEATURE="StaleImplNotUpdated"; ASPECT=Engine; STATUS=IMPL; UPDATED=2024-01-01
-// CANARY: REQ=CBIN-004; FEATURE="StaleBenchedToken"; ASPECT=Storage; STATUS=BENCHED; BENCH=Bench4; UPDATED=2025-10-30
+// CANARY: REQ=CBIN-004; FEATURE="StaleBenchedToken"; ASPECT=Storage; STATUS=BENCHED; BENCH=Bench4; UPDATED=2025-11-01