feat: adds format

Author: bdougie

cmd/formats.go

@@ -0,0 +1,40 @@
+package cmd
+
+import (
+	"fmt"
+	"rules-cli/internal/formats"
+
+	"github.com/spf13/cobra"
+)
+
+// formatsCmd represents the formats command
+var formatsCmd = &cobra.Command{
+	Use:   "formats",
+	Short: "List all available render formats",
+	Long: `List all supported render formats for the 'rules render' command.
+Each format represents a different AI code assistant platform with specific
+folder structures and file extensions.`,
+	Example: `  rules formats`,
+	RunE: func(cmd *cobra.Command, args []string) error {
+		fmt.Println("Available render formats:")
+		fmt.Println()
+
+		formatList := formats.GetAllFormats()
+		for _, format := range formatList {
+			if format.IsSingleFile {
+				fmt.Printf("%-10s - %s (%s)\n", format.Name, format.SingleFilePath, format.Description)
+			} else {
+				fmt.Printf("%-10s - %s/*%s (%s)\n", format.Name, format.DirectoryPrefix, format.FileExtension, format.Description)
+			}
+		}
+
+		fmt.Println()
+		fmt.Println("Usage: rules render <format>")
+		
+		return nil
+	},
+}
+
+func init() {
+	rootCmd.AddCommand(formatsCmd)
+}

internal/formats/formats.go

@@ -14,6 +14,7 @@ type Format struct {
 	FileExtension   string
 	IsSingleFile    bool
 	SingleFilePath  string
+	Description     string
 }
 
 // GetFormat returns a Format for the given format name
@@ -25,6 +26,7 @@ func GetFormat(formatName string) Format {
 			DirectoryPrefix: ".rules",
 			FileExtension:   ".md",
 			IsSingleFile:    false,
+			Description:     "Default rules format",
 		}
 	}
 
@@ -36,20 +38,23 @@ func GetFormat(formatName string) Format {
 			DirectoryPrefix: ".continue/rules",
 			FileExtension:   ".md",
 			IsSingleFile:    false,
+			Description:     "Continue Dev rules",
 		}
 	case "cursor":
 		return Format{
 			Name:            "cursor",
 			DirectoryPrefix: ".cursor/rules",
 			FileExtension:   ".mdc",
 			IsSingleFile:    false,
+			Description:     "Cursor rules",
 		}
 	case "windsurf":
 		return Format{
 			Name:            "windsurf",
 			DirectoryPrefix: ".windsurf/rules",
 			FileExtension:   ".md",
 			IsSingleFile:    false,
+			Description:     "Windsurf rules",
 		}
 	case "claude":
 		return Format{
@@ -58,13 +63,15 @@ func GetFormat(formatName string) Format {
 			FileExtension:   ".md",
 			IsSingleFile:    true,
 			SingleFilePath:  "CLAUDE.md",
+			Description:     "Claude Code single file",
 		}
 	case "copilot":
 		return Format{
 			Name:            "copilot",
 			DirectoryPrefix: ".github/instructions",
 			FileExtension:   ".instructions.md",
 			IsSingleFile:    false,
+			Description:     "GitHub Copilot instructions",
 		}
 	case "codex":
 		return Format{
@@ -73,20 +80,23 @@ func GetFormat(formatName string) Format {
 			FileExtension:   ".md",
 			IsSingleFile:    true,
 			SingleFilePath:  "AGENT.md",
+			Description:     "Codex single file",
 		}
 	case "cline":
 		return Format{
 			Name:            "cline",
 			DirectoryPrefix: ".clinerules",
 			FileExtension:   ".md",
 			IsSingleFile:    false,
+			Description:     "Cline rules",
 		}
 	case "cody":
 		return Format{
 			Name:            "cody",
 			DirectoryPrefix: ".sourcegraph",
 			FileExtension:   ".rule.md",
 			IsSingleFile:    false,
+			Description:     "Sourcegraph Cody rules",
 		}
 	case "amp":
 		return Format{
@@ -95,6 +105,7 @@ func GetFormat(formatName string) Format {
 			FileExtension:   ".md",
 			IsSingleFile:    true,
 			SingleFilePath:  "AGENT.md",
+			Description:     "Amp single file",
 		}
 	default:
 		// For any other format, use .<format>/rules
@@ -103,6 +114,7 @@ func GetFormat(formatName string) Format {
 			DirectoryPrefix: fmt.Sprintf(".%s/rules", formatName),
 			FileExtension:   ".md",
 			IsSingleFile:    false,
+			Description:     fmt.Sprintf("%s rules", formatName),
 		}
 	}
 }
@@ -197,3 +209,19 @@ func RenderRules(sourceDir string, targetFormat Format) error {
 	// Use the transformer to process the rule files
 	return ProcessRuleFiles(sourceDir, targetFormat)
 }
+
+// GetAllFormats returns a list of all supported formats
+func GetAllFormats() []Format {
+	formats := []Format{
+		GetFormat("continue"),
+		GetFormat("cursor"),
+		GetFormat("windsurf"),
+		GetFormat("claude"),
+		GetFormat("copilot"),
+		GetFormat("codex"),
+		GetFormat("cline"),
+		GetFormat("cody"),
+		GetFormat("amp"),
+	}
+	return formats
+}

spec/commands/formats.md

@@ -0,0 +1,20 @@
+# `rules formats`
+
+Lists all available render formats for the `rules render` command.
+
+## Usage
+
+```bash
+rules formats
+```
+
+## Args
+
+None
+
+## Behavior
+
+- Displays a list of all supported render formats
+- Shows the target directory/file and description for each format
+- Provides usage example for the `rules render` command
+- Does not modify any files