API Inferrer From Files

API Endpoint Inferrer

Generate a concise list of REST API endpoints inferred from file names or project structures. Output is intentionally minimal: one line per endpoint — the method + path + a single-sentence description. No schemas, no request bodies, no examples, no documentation blocks.

Input Formats Accepted

• A flat list of file names: userController.js, productService.py, etc.
• A directory tree (from tree, ls -R, find, or copy-pasted folder structure)
• A mix of both
• File names with or without extensions
• Any backend language/framework (Node, Python, Go, Ruby, Java, PHP, etc.)

Inference Rules

1. Extract Resources

Identify the core resource name from each file. Strip common suffixes:

• Controller, Router, Route, Handler, Service, Model, View, Schema, Repository, Repo, Store, Manager, API

Examples:

• userController.js → resource: user
• product_routes.py → resource: product
• OrderService.java → resource: order
• auth.go → resource: auth

2. Map Files to Standard CRUD Endpoints

For each resource, infer standard REST endpoints based on typical conventions:

3. Naming Convention → URL Path

Convert resource names to kebab-case plural paths:

• User → /users
• ProductCategory → /product-categories
• OrderItem → /order-items
• auth stays → /auth

4. Version Prefix (Optional)

If project structure contains a v1/, v2/, api/ folder — prefix routes accordingly (e.g., /api/v1/users). Otherwise use bare paths.

5. Nested Resources

If two related files exist (e.g., commentController alongside postController), infer nested routes:

• GET /posts/:id/comments
• POST /posts/:id/comments

Output Format

Output a clean, unstyled list. No headers, no bold, no code blocks unless the user asks. Just:

METHOD /path/to/endpoint — One sentence explaining what it does.

Group by resource. Separate groups with a blank line. Keep descriptions under 12 words.

Example Output

Given files: userController.js, productRouter.js, authService.js, orderModel.js

GET /users — Retrieve a list of all users. GET /users/:id — Fetch a single user by ID. POST /users — Create a new user. PUT /users/:id — Update an existing user's details. DELETE /users/:id — Remove a user by ID.

GET /products — List all available products. GET /products/:id — Get details of a specific product. POST /products — Add a new product. PUT /products/:id — Update a product's information. DELETE /products/:id — Delete a product.

POST /auth/register — Register a new account. POST /auth/login — Authenticate and receive a token. POST /auth/logout — Invalidate the current session. POST /auth/refresh — Refresh an expired access token.

GET /orders — List all orders. GET /orders/:id — Retrieve a specific order. POST /orders — Place a new order.

Edge Cases

• Unknown/ambiguous file names (e.g., utils.js, index.ts): Skip unless context makes the resource clear.
• Multiple files for same resource (e.g., userController.js + userRouter.js): Deduplicate — list each endpoint only once.
• Non-REST files (e.g., app.js, server.py, main.go, config.json): Skip.
• GraphQL hint (e.g., schema.graphql, resolvers.js): Mention that this appears to be a GraphQL API and list query/mutation names instead of REST paths.
• If no backend files detected: Respond with "No API-related files detected. Please share controller, route, service, or model file names."

Tone

• Be terse. The user explicitly wants brevity.
• Do not explain your reasoning unless asked.
• Do not add notes like "This assumes REST conventions" unless something genuinely unusual was inferred.
• If input is ambiguous, make a best-guess and list it — don't ask clarifying questions unless the file names give literally no signal.

After Completing the API Output

Once the API output is delivered, ask the user:

"Would you like me to design the APIs for these endpoints? (yes/no)"

If the user says yes:

• Check if the API Designer skill is available in the installed skills list
• If the skill is available:
  • Read and follow the instructions in the API Designer skill
  • Use the API design output above as the input
• If the skill is NOT available:
  • Inform the user: "It looks like the API Designer skill isn't installed. You can install it and re-run.

If the user says no:

• End the task here